
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 = Card type 1 2 = Card type 2 |
| 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:
https://secure.paxum.com/payment/api/paymentAPI.php
POST
method=addCard&fromEmail=payee%40domain.com&nameOnCreditCard=name+on+the+card&cardType=1&creditCardNumber=0123456789012345&expirationDate=10-2012¤cy=USD&type=1&phone=0123456789&passportNumber=123456&passportExpirationDate=2013-02-15&addressId=123456&key=9061edab0201c874a77d13ecbfc60f2b
Response Sample
<?xml version="1.0"?>
<Response>
<Environment>PRODUCTION</Environment>
<Method>addCard</Method>
<ResponseCode>00</ResponseCode>
<ResponseDescription>Approved or Completed Successfully</ResponseDescription >
<Fee>0.00</Fee>
<TransactionId>23646236</TransactionId>
</Response>
Working Sample(s):
addCard.php