# 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

Reqeust 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

Reqeust 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

Reqeust 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

Reqeust method:

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

# Parameters

# Response

# Void a transaction

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

Reqeust method:

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

# Parameters

# Response

# Query order

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

Reqeust 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

Reqeust method:

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

# Parameters

# Response

# Demo and source code

Simple purchase: demo Recurring purchase: demo source code download