API Request

API 请求

接入方需要先获取token才能正常使用API

发送请求 使用不同的Service参数操作访问API

将所有的业务参数json序列化以后生成bizContent
使用商户私钥对bizContent进行签名，生成sign
对bizContent进行AES加密

通用请求

POST https://reload.chntax.cn/api/v2/card

使用POST方法

Headers

Name

Type

Description

Authorization*

String

Bearer token

例如： Bearer eyJ0eXAiOiJKV...

Request Body

Name

Type

Description

service*

String

例：createCard

bizContent*

String

AES加密后的字符串，包含所有业务参数

sign*

String

签名

{
    "statusCode": 0,
    "bizContent": "ZXlKcGRpSTZJbTgyUzA1cmJscDZha2xVVEdkNmRVWlRiSGRsZVdjOVBTSXNJblpoYkhWbElqb2lPRzVVY1RseFEyWkNSbVF4VEVacGJpOXBVemg0UlVwdlN6Rm1lbk5tZW14U2RVOTZhRFJ3TW1GcGJ6MGlMQ0p0WVdNaU9pSTFaR1kzWWpWaE5XUTFZV05rT0Rjek9UQmpNMk15WlRBME0yUm1aV1EwTlRoaE0yUTVOekpsTkRObE16SmpORE01WkdKak9UUmhNMk5rWWpnMk4yTTNJaXdpZEdGbklqb2lJbjA9",
    "sign": "J4079QgEUJdqZtx/9/L8m2ZCEcs/18un2w+vL9SNmM7EaxrWX3lEA6CObv3FLpRNKadtkdekCavy0MK3tL+vb95MAX7nDQakeYhBk0oVfIyQYhYCtskxSHFy9ZO+Ys8f2MCbPNwl489SnrskXOE0Azxvtsk22C6GmWuRMA4gbO7xoneg/lMlxyiu/mVkoHZ8E1bBQBdYK0G14M/XzU/Xchn6VzPCydW9t7+epVEKgz3dO9qKJk6Gz1P/3ui+s84gWn1jUToaHR23BGjEg9wZln1K/1x5CF6/kUjHhSfq1bAvD5ctsajKvYTaspv65dVh7untNLl5K1WAI7EZ1YFGog==",
    "timestamp": "2023-09-12 14:26:30 GMT+8"
}

API Request 示例

重要：service参数大小写敏感，请参照 API列表

service参数详见 API列表

<?php
$client = new Client();
$headers = [
  'Authorization' => 'Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOlwvXC9yZWxvYWQudGVzdFwvYXBpXC92MlwvbG9naW4iLCJpYXQiOjE2OTQ1MTI3ODgsImV4cCI6MTY5NDUxNjM4OCwibmJmIjoxNjk0NTEyNzg4LCJqdGkiOiJxMWlTQTdZbnROZ2U1bnA3Iiwic3ViIjoxMDAsInBydiI6IjIzYmQ1Yzg5NDlmNjAwYWRiMzllNzAxYzQwMDg3MmRiN2E1OTc2ZjcifQ.CfhtwYhBRmzusPH3EOOnQLO0XySNY7T_e90sDEkZ3IA',
  'Content-Type' => 'application/x-www-form-urlencoded'
];
$options = [
'form_params' => [
  'service' => 'createCard',
  'bizContent' => 'AgAv0CCKyfxCCX3Ou907purhD5Bs93AV2NzELRn6GWxwxhv6aMsAT3YM3q1sSu+SNQrJNh2s2RuduUgB/bnlU9OK6UbSNVEGN2sASha6NuuS/phda4vG/ihPTguEgmYrsrS5ukYJ2gOiShrvthGLH9fsemAQnGZS4+AOuB2U0DZvbQfIkjweE8E1xuVu15DzFDzbM+1dFO/Uc8gngiTzeCipNLMl4sGzjc/+r30j+5ZbyGQP67DBo9i2hMyCiApGrAbhnTLQ3QCi8CNAGyt1Cme6NC1lnjhigj/QNkR/f3CJAm+lz5hKOQZ6O1KnY5WYtawNHQcST+38Vi3lO6BV/tkI6R/n7twEEnxtHPoV6GJyuebFAbzrTX3tyq0ibJ5lB8xFM8I1t7qMOepEu6Dj8gcThQwRRTBLx3kWBz0BA3lLRwbxkfYsqqOksrCnLvrycQATlLUcrOJ7vuOxqiDpnsZpcd57wZo2gPc68AdLs9kTSP2criGpEAcD5mGQZH7YUHRc2LnB93U8WU22fI81xATNJ+e++D9RtjaIeCOScNKnE9g7PjasOYy0riMbQgSJPOR9V5Zvc3aEYQ+VRQePa44XDg5sTbmGLbev8BKqlAYupmzUL898mEGF8NxBVwMB9qw2HQh0Kmg8PjIqrRdADTtmABLf2OvL+WZTgufIGUQ=',
  'sign' => 'UD26CyfptzTq9GQnRZLl530BsU/Gje7v69wm6UeBuJ9+htqg225UFkjyWE/homEHD2G9h6TXcjJezfZPfJkJZgY/0JMYV2AxbClKnowOceiVBn1Vzh0YsmEtAed98U5aPgEIRxOWyN+5zUv3ZSFBhajHlm5sBEo6VBLskTg9UCYTp3pm3jGcLE6jZ6xdsjTmLEjnUKFCdg4uNJj7AEs3WtsLJ4qQ1Ul76OTRts9X9Dm+d0QfVi6RhmoOhFiHGVPfb3kouHO8zSHesSnNohyXemlzTv2CKx32wSbH/giqHWeLl3lHE548a/rcA+nBX7WseiEQQMwu1sKR91g81FqpXA=='
]];
$request = new Request('POST', 'http://reload.test/api/v2/card', $headers);
$res = $client->sendAsync($request, $options)->wait();
echo $res->getBody();

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("application/x-www-form-urlencoded");
RequestBody body = RequestBody.create(mediaType, "service=createCard&bizContent=AgAv0CCKyfxCCX3Ou907purhD5Bs93AV2NzELRn6GWxwxhv6aMsAT3YM3q1sSu+SNQrJNh2s2RuduUgB/bnlU9OK6UbSNVEGN2sASha6NuuS/phda4vG/ihPTguEgmYrsrS5ukYJ2gOiShrvthGLH9fsemAQnGZS4+AOuB2U0DZvbQfIkjweE8E1xuVu15DzFDzbM+1dFO/Uc8gngiTzeCipNLMl4sGzjc/+r30j+5ZbyGQP67DBo9i2hMyCiApGrAbhnTLQ3QCi8CNAGyt1Cme6NC1lnjhigj/QNkR/f3CJAm+lz5hKOQZ6O1KnY5WYtawNHQcST+38Vi3lO6BV/tkI6R/n7twEEnxtHPoV6GJyuebFAbzrTX3tyq0ibJ5lB8xFM8I1t7qMOepEu6Dj8gcThQwRRTBLx3kWBz0BA3lLRwbxkfYsqqOksrCnLvrycQATlLUcrOJ7vuOxqiDpnsZpcd57wZo2gPc68AdLs9kTSP2criGpEAcD5mGQZH7YUHRc2LnB93U8WU22fI81xATNJ+e++D9RtjaIeCOScNKnE9g7PjasOYy0riMbQgSJPOR9V5Zvc3aEYQ+VRQePa44XDg5sTbmGLbev8BKqlAYupmzUL898mEGF8NxBVwMB9qw2HQh0Kmg8PjIqrRdADTtmABLf2OvL+WZTgufIGUQ=&sign=UD26CyfptzTq9GQnRZLl530BsU/Gje7v69wm6UeBuJ9+htqg225UFkjyWE/homEHD2G9h6TXcjJezfZPfJkJZgY/0JMYV2AxbClKnowOceiVBn1Vzh0YsmEtAed98U5aPgEIRxOWyN+5zUv3ZSFBhajHlm5sBEo6VBLskTg9UCYTp3pm3jGcLE6jZ6xdsjTmLEjnUKFCdg4uNJj7AEs3WtsLJ4qQ1Ul76OTRts9X9Dm+d0QfVi6RhmoOhFiHGVPfb3kouHO8zSHesSnNohyXemlzTv2CKx32wSbH/giqHWeLl3lHE548a/rcA+nBX7WseiEQQMwu1sKR91g81FqpXA==");
Request request = new Request.Builder()
  .url("http://reload.test/api/v2/card")
  .method("POST", body)
  .addHeader("Authorization", "Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOlwvXC9yZWxvYWQudGVzdFwvYXBpXC92MlwvbG9naW4iLCJpYXQiOjE2OTQ1MTI3ODgsImV4cCI6MTY5NDUxNjM4OCwibmJmIjoxNjk0NTEyNzg4LCJqdGkiOiJxMWlTQTdZbnROZ2U1bnA3Iiwic3ViIjoxMDAsInBydiI6IjIzYmQ1Yzg5NDlmNjAwYWRiMzllNzAxYzQwMDg3MmRiN2E1OTc2ZjcifQ.CfhtwYhBRmzusPH3EOOnQLO0XySNY7T_e90sDEkZ3IA")
  .addHeader("Content-Type", "application/x-www-form-urlencoded")
  .build();
Response response = client.newCall(request).execute();

API 响应

API 返回为json格式, 当statusCode=0时表示API请求成功，具体的业务返回参数在bizContent中

{
    "statusCode": 0,
    "bizContent": "ZXlKcGRpSTZJbTgyUzA1cmJscDZha2xVVEdkNmRVWlRiSGRsZVdjOVBTSXNJblpoYkhWbElqb2lPRzVVY1RseFEyWkNSbVF4VEVacGJpOXBVemg0UlVwdlN6Rm1lbk5tZW14U2RVOTZhRFJ3TW1GcGJ6MGlMQ0p0WVdNaU9pSTFaR1kzWWpWaE5XUTFZV05rT0Rjek9UQmpNMk15WlRBME0yUm1aV1EwTlRoaE0yUTVOekpsTkRObE16SmpORE01WkdKak9UUmhNMk5rWWpnMk4yTTNJaXdpZEdGbklqb2lJbjA9",
    "sign": "J4079QgEUJdqZtx/9/L8m2ZCEcs/18un2w+vL9SNmM7EaxrWX3lEA6CObv3FLpRNKadtkdekCavy0MK3tL+vb95MAX7nDQakeYhBk0oVfIyQYhYCtskxSHFy9ZO+Ys8f2MCbPNwl489SnrskXOE0Azxvtsk22C6GmWuRMA4gbO7xoneg/lMlxyiu/mVkoHZ8E1bBQBdYK0G14M/XzU/Xchn6VzPCydW9t7+epVEKgz3dO9qKJk6Gz1P/3ui+s84gWn1jUToaHR23BGjEg9wZln1K/1x5CF6/kUjHhSfq1bAvD5ctsajKvYTaspv65dVh7untNLl5K1WAI7EZ1YFGog==",
    "timestamp": "2023-09-12 14:26:30 GMT+8"
}

处理返回参数

将bizContent字段做AES解密
对解密后的bizContent字段验签

bizContent 业务数据示例

{
  "returnCode": "000000",
  "errorMessage": "Success",
  "cardLogId": "9448b6a7b3bcb22f99c1bedd246aba092c7932fd5e7f3042607bf58bc7cc3d83",
  "cardNum": "5229811460053354",
  "cardExpirationDate": "2406",
  "cvv2": "123",
  "cardType": "GWTTP",
  "cardLabel": "MasterCard"
}

重要：为保证业务安全，请对返回参数验签

上一页API Access 下一页API Reference

最后更新于2年前