Token Property

This property is used to reference a specific Express Checkout transaction in the PayPal network.

Syntax

• C++
• Objective-C
• C

ANSI (Cross Platform)
char* GetToken();
int SetToken(const char* lpszToken);

Unicode (Windows)
LPWSTR GetToken();
INT SetToken(LPCWSTR lpszToken);

@property (nonatomic,readwrite,assign,getter=token,setter=setToken:) NSString* token;
- (NSString*)token;
- (void)setToken:(NSString*)newToken;

#define PID_EXPRESSCHECKOUT_TOKEN 69

INPAY_EXTERNAL void* INPAY_CALL InPay_ExpressCheckout_Get(void *lpObj, int propid, int arridx, int *lpcbVal, int64 *lpllVal);
INPAY_EXTERNAL int INPAY_CALL InPay_ExpressCheckout_Set(void *lpObj, int propid, int arridx, const void *val, int cbVal);

Default Value

""

Remarks

PayPal will return a token in the ResponseToken property in response to each request. This value should be saved and passed in the Token property for a CheckoutPayment request, or to modify an existing transaction.

This token expires after three hours.

IMPORTANT: the value of this property can be used to modify an existing checkout session. Normally you call SetCheckout with an empty Token property, and get a ResponseToken back from the PayPal servers. Calling SetCheckout again with the Token property filled will edit that previous checkout session. For instance, this can be used should you want the customer to edit his shipping address on PayPal.

This property is required when calling the CheckoutPayment method.

This property is optional when calling the SetCheckout method.

Character length and limitations: 20 single-byte characters.

Data Type

String