Credit Card API V2(Deprecated)

• Only CAD transaction supported.
  

• There are two modes for credit card integration:
  Simple Purchase
  Recurring Purchase

Sign generate and check

Sign algorithm

Request and response format

All request and response are JSON format

Sending request demo code

$arr = array(
    'customerId' => '0000000123',
    'mchOrderNo' => 'm12345',
    'mchId' => 'your merchant id',
  	'currency' => 'CAD',
    'amount' => 100,   // in cents
    'jobNo' => 'jack', //your login name
    'notifyUrl' => 'http://yourdomain.com/notifyme.php',
    'returnUrl' => 'http://yourdomain.com/returnhere.php',
    'subject' => "ipad pro",
    'body' => '64G,wifi,white'
);
$Utility = new Utility();
$sort_array = $Utility->arg_sort($arr);   //sort the parameters
$arr['sign'] = $Utility->build_mysign($sort_array, $merchantKey, "MD5");   //generate sign and put it into the array
$param = json_encode($arr);    //generate json string to send
$resBody = $Utility->request($url, $param);//Submit to the gateway

$res = json_decode($resBody, true);
if ($res['retCode'] == 'SUCCESS') {
    header('Location: ' . $res['payUrl']);//Redirect to payment page
} else {
    echo $res['msg'];
}

Simple purchase

User input card info and purchase once, users will be prompted to input card info each time when they purchase.

Sequence

1, Call cc_purchase and redirect to payUrl to let user input credit card info;
2, After purchase, will redirect to returnUrl;
3, If the transaction is successful, IOTPay will notify to notifyUrl;

Request URL for simple purchase

Endpoint: https://api.iotpaycloud.com/v2/cc_purchase

Request method:

• POST
• Content-Type: application/json;charset=UTF-8

Parameters

Response

NotifyUrl message

ReturnUrl parameters

Recurring purchase

User input card info once, can purchase with the tokenized card multiple times.

Sequence

1, Call cc_adduser and then redirect to payUrl to let user input credit card info;
2, After adduser, will redirect to returnUrl with the following parameters:
If success: retCode=SUCCESS&customerId=xxx&cardNumber=450116XXXXXX7214&expirationDate=0725&cardType=V&sign=xxxx
If fail: retCode=FAIL&customerId=xxxx&sign=xxxx
3, If adduser is successful, call cc_purchasewithtoken to do real purchase

sign check

Request URL for adduser

Endpoint: https://api.iotpaycloud.com/v2/cc_adduser

Request method:

• POST
• Content-Type: application/json;charset=UTF-8

Parameters

each customerId can bind only one credit card, if one user need to bind more cards, use different customerId

Response

ReturnUrl parameters

Request URL for purchasewithtoken

Endpoint: https://api.iotpaycloud.com/v2/cc_purchasewithtoken

Request method:

• POST
• Content-Type: application/json;charset=UTF-8

Parameters

Response

Basic parameters in order

Refund a transaction

Endpoint: https://api.iotpaycloud.com/v2/cc_refund

Request method:

• POST
• Content-Type: application/json;charset=UTF-8

Parameters

Response

Void a transaction

Endpoint: https://api.iotpaycloud.com/v2/cc_void

Request method:

• POST
• Content-Type: application/json;charset=UTF-8

Parameters

Response

Query order

Endpoint: https://api.iotpaycloud.com/v2/cc_query

Request method:

• POST
• Content-Type: application/json;charset=UTF-8

Parameters

use either payOrderId or mchOrderNo, use one of them

Response

Query user binding status

Endpoint: https://api.iotpaycloud.com/v2/cc_isbinding

Request method:

• POST
• Content-Type: application/json;charset=UTF-8

Parameters

Response

Demo and source code

Simple purchase: demo

Recurring purchase: demo

source code download