CardPay

Use this API to transfer money to beneficiary cards. Provide details such as beneficiary name, card type, network type, and transfer ID.

You need to pass the tokenised card number or card token for this transfer.

Please use this Authorization token in headers to call any payout API (Refresh this page if the token is expired)

Click to view the tokens to test CardPay integration.

Test Token	Response in UAT
4895379990484220	SUCCESS
5480981500100002	SUCCESS
5480981500100003	FAILURE
4895379990484221	FAILURE

Click to view the response codes.

Sub Code	Status	Message	Next Action
200	SUCCESS	Transfer completed successfully	None
201	PENDING	Transfer request pending at the bank	None
400	ERROR	Transfer Id already exists	Provide a different transfer ID
403	ERROR	Token is not valid	Validate the token
403	ERROR	APIs not enabled. Please fill out the Support Form	Please fill out the Support Form
412	ERROR	Not enough available balance in the account	Try again with sufficient account balance
422	ERROR	Please provide valid token details	Provide a valid token
422	ERROR	amount should be at least 1.0	Enter a transfer amount that is equal to or more than Rs. 1.
422	ERROR	Invalid bank account number or ifsc provided	Provide valid bank account details
422	ERROR	Please provide a valid Name	Provide a valid name
422	ERROR	Please provide a valid networkType	Provide a valid network type
422	ERROR	cardType is invalid	Provide a valid card type
422	ERROR	transferId can contain only alphabets, numbers, hyphen and underscore	Provide a valid transfer ID

Headers

Authorization · string · required

Bearer Auth Token

Content-Type · string · required

application/json

Body

application/json

token · string · required

It is the tokenised card number or card token for this transfer.

amount · string · required

Amount you want to transfer. Amount should be >= 1.00. Decimals are allowed.

transferId · string · required

Unique transfer ID to identify the transfer. Alphanumeric characters and underscore are allowed. The maximum character limit is 40.

cardType · string · required

Specify if it is a debit or credit card. Values allowed: DEBIT/CREDIT. CREDIT is the default value if the parameter does not exist or is not specified.

remarks · string

Remarks for your reference. Alphanumeric characters and whitespace are allowed. The maximum character limit is 70.

name · string

The name of the beneficiary who receives the transfer amount.

networkType · string

Specify the card type - VISA/MASTERCARD.

cryptogram · string

It ​contains formatted chip/cryptogram data relating to the token cryptogram. The maximum character limit is 600. It is optional for MASTERCARD and not required for VISA.

tokenExpiry · string

Applicable only for MASTERCARD. The format for the valid token expiry date should be YYYY-MM. It cannot be null. Provide a valid tokenExpiry if collected from the customers. If unavailable, populate a static value with a forward year and month in the correct format (YYYY-MM). The maximum character limit is 10.

tokenPANSequenceNumber · string

A maximum of 3 alphanumeric characters are allowed. It is optional for MASTERCARD and not required for VISA.

Response

200

application/json

200

status · string

Example:

"SUCCESS"

subCode · string

Example:

"200"

message · string

Example:

"Transfer completed successfully"

data · object

Show child attributes