更新日志

暂无更新日志记录

FAQ

暂无常见问题解答

签名规则

为了确保数据在传输过程中不被篡改，系统要求您对支付参数数据进行签名，并将数据签名随同支付请求一起上送

MD5签名

• 系统所有接口签名方式都为MD5,具体的签名字段可参考每个接口的签名(sign)参数备注
• 验证签名，您可对字符串123456进行MD5签名，签名结果得到字符串E10ADC3949BA59ABBE56E057F20F883E，即可认为签名正确
• 签名规则：把所字段按照字母a到z顺序进行拼接，然后进行MD5签名,为空的字段不参与签名
• 商户密钥由Tapxyz方提供

卡片列表接口

卡片列表接口

• 接口地址：
• 生产: https://card.tapxyz.com/getCardNameList
• 沙盒: https://sandbox.tapxyz.com/getCardNameList
  
• 请求方式：GET #### 响应参数

响应数据参数

发卡接口

发卡接口

请求参数

• 接口地址：
• 生产: https://card.tapxyz.com/card/issue
• 沙盒: https://sandbox.card.tapxyz.com/card/issue
• 请求方式：POST
• 请求头：Content-Type:application/json
• body参数:
  

body参数

{
  "merNo":"",
  "seqNo":"",
  "cardName":"",
  "currencyCode":"",
  "lastName":"",
  "firstName":"",
  "cardType":"",
  "certificateType":"",
  "certificateNo":"",
  "dateOfBirth":"",
  "gender":"",
  "maritalStatus":"",
  "billingCity":"",
  "billingAddress":"",
  "billingType":"",
  "billingAddressType":"",
  "postalCode":"",
  "email":"",
  "notifyUrl":"",
  "sign":""
}

请求示例

public class Test{
  public static void main(String[] args){
    JSONObject jsonObject = new JSONObject();
    jsonObject.put("merKey", "");
    jsonObject.put("seqNo", "");
    jsonObject.put("cardName", "");
    jsonObject.put("currencyCode","");
    //.....除签名(sign)以外的所有的body参数

    //签名
    String sign = MD5(merKey+certificateNo+email+商户密钥);
    jsonObject.put("sign", sign);

    String url = "https://card.tapxyz.com/card/issue";
    HttpResponse httpResponse = HttpRequest.post(url)
                    .body(jsonObject.toJSONString(), "application/json")
                    .execute();
    int status = httpResponse.getStatus();
    if(status == HttpStatus.HTTP_OK){
        String content = httpResponse.body();
    }
  }
}

响应参数

发卡异步通知

• 如果商户系统接收到Tapxyz通知后没有返回SUCCESS(区分大小写)字符串,Tapxyz会认为商户系统没有收到通道，Tapxyz会在第1，2，4，8，16，32，64，128分钟之后再次发起通知，Tapxyz总共会发起9次通知，如果商户系统在8次通知中都没有返回SUCCESS，则Tapxyz不会再发起通知。

请求参数

• 接口地址：notifyUrl开卡传递的地址
• 请求方式：POST
• 请求头：Content-Type:application/json
• body参数:

设置卡密码

请求参数

• 接口地址：
• 生产: https://card.tapxyz.com/card/setPassword
• 沙盒: https://sandbox.card.tapxyz.com/card/setPassword
• 请求方式：POST
• 请求头：Content-Type:application/json
• 请求参数：

响应参数

转账接口

转账接口

请求参数

• 接口地址：
• 生产: https://card.tapxyz.com/transfer
• 沙盒: https://sandbox.card.tapxyz.com/transfer
• 请求方式：POST
• 请求头：Content-Type:application/json
• body参数:

{
  "seqNo":"",
  "cardNumber":"",
  "amount":"",
  "cardNumberUntil":"",
  "userName":"",
  "paymentPassword":"",
  "sign":""
}

响应参数

查询转账记录

请求参数

• 接口地址：
• 生产: https://card.tapxyz.com/transfer/query
• 沙盒: https://sandbox.card.tapxyz.com/transfer/query
  
• 请求方式：POST
• 请求头：Content-Type:application/json
• body参数:

{
  "userId":"",
  "type":"",
  "sign":""
}

响应参数

响应数据参数

充值接口

充值接口

请求参数

• 接口地址：
• 生产: https://card.tapxyz.com/recharge
• 沙盒: https://sandbox.card.tapxyz.com/recharge
  
• 请求方式：POST
• 请求头：Content-Type:application/json
• body参数:

{
  "merNo":"",
  "seqNo":"",
  "amount":"",
  "transDestAcctNo":"",
  "payBankName":"",
  "payAccountName":"",
  "payBankCode":"",
  "payVoucherUrl":"",
  "payCardNo":"",
  "notifyUrl":"",
  "sign":""
}

响应参数

充值异步通知

• 如果商户系统接收到Tapxyz通知后没有返回SUCCESS(区分大小写)字符串,Tapxyz会认为商户系统没有收到通道，Tapxyz会在1，2，4，8，16，32，64，128分钟之后再次发起通知，Tapxyz总共会发起9次通知，如果商户系统在8次通知中都没有返回SUCCESS，则Tapxyz就不会再发起通知。

请求参数

• 接口地址：notifyUrl充值传递的地址
• 请求方式：POST
• 请求头：Content-Type:application/json
• body参数:

文件上传接口

请求参数

• 接口地址：https://upload.tapxyz.com/upload
• 请求方式：POST
• 请求头：multipart/form-data
• 请求参数：

响应参数

国家编码

错误码