developer_guide:call_reference:trialtofullrequest

This is an old revision of the document!


TrialToFullRequest Call Reference

TrialToFullRequest allows you to switch the initial billing phase to the second billing phase. The initial billing phase is typically used for a Trial or Free Trial, but it could be any billing period that is different than the next billing phase.

View:

TrialToFullRequest

Overview

The box below lists all fields that could be included in the call request. To learn more about an individual field or its type, scroll down to find it in the table below the box.

XML

<?xml version="1.0" encoding="utf-8"?>
    <TrialToFullRequest>
        <Username>string</Username>	
        <Token>string</Token>
        <Guid>string</Guid>
        <CreditCard>
             <CardNumber>string</CardNumber>
             <CardType>string</CardType>
             <ExpMonth>string</ExpMonth>
             <ExpYear>string</ExpYear>
             <SecureCode>string</SecureCode>
        </CreditCard>
        <Customer>
               <Email>string</Email>
               <FirstName>string</FirstName>
               <LastName>string</LastName>
               <BillingAddress>
                      <FirstName>string</FirstName>
                      <LastName>string</LastName>
                      <Company>string</Company>
                      <Address>string</Address>
                      <Address2>string</Address2>
                      <City>string</City>
                      <Region>string</Region>
                      <PostalCode>string</PostalCode>
                      <Country>string</Country>
                      <Phone>string</Phone>
               </BillingAddress>
               <ShippingAddress>
                      <FirstName>string</FirstName>
                      <LastName>string</LastName>
                      <Company>string</Company>
                      <Address>string</Address>
                      <Address2>string</Address2>
                      <City>string</City>
                      <Region>string</Region>
                      <PostalCode>string</PostalCode>
                      <Country>string</Country>
                      <Phone>string</Phone>
               </ShippingAddress>
               <Password>string</Password>
               <Account>string</Account>
        </Customer>		
    </TrialToFullRequest>

Elements

Name Type Occurrence Meaning
UpdateCreditCardRequest container required Parent Element
Username string required Merchant API username (this is not your SubscriptionBridge login id)
Token string required Your application's security token. view also: How to create a token
Guid string required The Subscription Unique ID
CreditCard container required Parent Element
CardNumber string required Credit Card Number
CardType string required Credit Card Type (e.g. Visa, Amex, Mastcard
ExpMonth string required 2 digit month
ExpYear string required 4 digit year
SecureCode string required CVV Code on back of card

UpdateCreditCardResponse

Overview

The box below lists all fields that could be included in the call response. To learn more about an individual field or its type, scroll down to find it in the table below the box.

XML

<?xml version="1.0" encoding="utf-8"?>
    <UpdateCreditCardResponse>
        <Ack>string</Ack> 
	<Timestamp>timestamp</Timestamp>
    </UpdateCreditCardResponse>

Elements

Name Type Occurrence Meaning
UpdateCreditCardResponse container required Parent Element
Ack string always Success, Error, or Warning
Timestamp string always All responses return the official SB time stamp in UTC/GMT
developer_guide/call_reference/trialtofullrequest.1330218961.txt.gz · Last modified: 2012/02/24 23:00 (external edit)