This website uses cookies to ensure you have the best experience. By continuing to use this site, you consent to our Cookie policy.
You can disable cookies at any time, by changing your browser settings.
Accept and close

Add Card

Here you can add an external card

Field Name Len Type Req Ver Comments
method N/A Alp-Num Yes 1.1 addCard
fromEmail N/A Alp-Num Yes 1.1 The email associated with the account to wich the card will be added
cardName N/A Alp Yes 1.1 The name on the card
cardType 1 Num Yes 1.1 1 = VISA
2 = MasterCard
cardNumber N/A Num Yes 1.1 The Card Number
cardExpiration 7 Date Yes 1.1 Card Expiration Date (mm-yyyy)
currency 3 Alp Yes 1.1 The currency of the Card (eg USD)
type N/A Num Yes 1.1 1 = Primary
2 = Secondary
phone 10 Num Yes 1.1 Contact Number with country code (eg 19872547805)
idNumber N/A Alp-Num Yes 1.1 Passport Number or Government Issued ID (eg H144556)
idExpiration 10 Date Yes 1.1 Passport or Government Issued ID expiration Date (eg 2020-12-31)
addressId N/A Alp Yes 1.1 The ID of the address within the account wich is used as billing address for this card
key N/A Alp-Num Yes 1.1 MD5(sharedSecret + cardName + cardType + cardNumber + cardExpiration + cardVerificationNumber + currency + type + phone + idNumber + idExpiration + addressId )

This request is responded by a message with the following content:

Field Name Len Type Mdt Ver Comments
ResponseCode N/A Alp-Num Yes 1.1 The response code; 00 = Success;
ResponseDescription N/A Alp-Num Yes 1.1 Human readable response
Fee N/A Real Yes 1.1 Fee for the current transaction
TransactionId N/A Num Yes 1.1 The transaction ID if successfully, otherwise not specified

Request Sample:

Response Sample

<?xml version="1.0"?>
    <ResponseDescription>Approved or Completed Successfully</ResponseDescription >

Working Sample(s):