Developers / API / Add Card
Add Card

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:

https://www.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&currency=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