# Credit Card API V2(不建议使用，请对接V3版本)

• 仅支持加元交易.
  

• 有两种应用流程:
  简单购买流程
  重复购买流程

# 生成签名和签名验证

Sign algorithm

# Request和response参数格式

均为JSON格式

# 发送请求范例

$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'];
}

# 简单购买流程

用户每次购买都需要输入信用卡信息.

# Sequence

1, 调用 cc_purchase 然后重定向到 payUrl，用户在这里输入信用卡信息;
2, 购买结束后, 会重定向到 returnUrl;
3, 如果交易成功, IOTPay会发送notify message到 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

绑定用户和信用卡信息，方便后续重复购买，避免每次购买都要输入信用卡信息。

# Sequence

1, 调用 cc_adduser 并且重定向到 payUrl，用户在这里输入信用卡信息;
2, 用户输入卡信息后，会重定向到returnUrl:
如果成功: retCode=SUCCESS&customerId=xxx&cardNumber=450116XXXXXX7214&expirationDate=0725&cardType=V&sign=xxxx
如果失败: retCode=FAIL&customerId=xxxx&sign=xxxx
3, 如果绑定用户成功, 调用 cc_purchasewithtoken 发起真实支付

# Request URL for adduser

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

Reqeust method:

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

# Parameters

每个 customerId 只能绑定一张信用卡, 如果同一个用户需要绑定多张信用卡, 需要使用不同的 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

** payOrderId 或者 mchOrderNo, 传递其中一个就可以**

# 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