logo

Appendix

Request & response code description

Transfer status

Status
Description
pending
create payment success, xCurrency on processing
awaiting_transfer
Waiting for remittance, only in this state can remittance be operated
transferring
tranferring
completed
transferred to user success
failed
transfer fail, wait to refund
rejected
the compliance not pass and so on
invalid
The exchange rate is invalid, reconfirm the exchange rate
canceled
payment cancel
refunding
refunding
refunded
refund completed

Error Code

状态
描述
1
请求成功
-1
非法请求。'message' 包含详细的错误消息
10001
签名检查错误
10002
Appkey 错误
10003
报价已过期
10004
参数校验失败
10005
无法转移支付,支付状态不是 等待转账
10006
超出时间限制无法汇款
10007
余额不足
10008
发件人信息未通过KYC审核,支付将不会在xCurrency Hubs' 端创建
10009
转账失败,如果有任何问题,请通过电子邮件联系xCurrency Hubs
10010
收款人的账户异常。请验证收款人账户
10011
收款人的账户异常。收款人的银行系统不支持,请尝试使用其他卡
10012
收款人的账户异常。收款人的身份证已过期
10013
收款人的账户异常。检测到非银联卡。请使用银联卡
10014
收款人的账户异常。超过银行限额
10015
发件人信息异常。如果你有任何问题,请通过电子邮件联系xCurrency Hubs
10016
风险控制
10017
取消失败,请检查支付状态。
10018
发件人ID过期日期无效。
10019
发件人出生日期无效。
10020
黑名单发件人。
10021
收款人ID过期日期无效。
10022
黑名单收款人。
10023
收款人出生日期无效。

Source of Funds

Enum
Description
Business income
盈利收入
Employment income
雇佣薪酬
Part-time income
兼职收入
Saving deposits
储蓄存款

Purpose Of Transfer

Enum
Description
Family support
赡养家庭
Salary
工资报酬

Beneficiary and Sender Relationship

Enum
Description
Children
子女
Parent
父母
Relative
其他亲戚
Self
自己
Sibling
兄弟姐妹
Spouse
配偶

Postman Collections

为了方便使用我们 API,我们提供了 postman 文件,可以通过以下按钮直接点击打开 postman app。通过与 postman app 交互,可以直接测试我们的接口,方便你快速接入。
postman 使用可以查阅 postman 使用教程
Image without caption

KYC Documents

👥SFTP Installation Steps and Use Tutorial (Client-Side)

FAQ

  1. 在使用其他语言进行加密时,如何在与服务通信后验证加密是否正确?
    1. 你可以通过验证API检查加密是否正确。
  1. 使用sftp时如何同步文件?
    1. 请查阅sftp指南
  1. 如何处理有转账异常的付款?
    1. 异常付款由我们的员工处理。您可以联系我们获取更多信息。
  1. 当响应的http状态码为400,body包含errorsmessage属性,这是什么意思?
    1. 这通常是错误消息,只需查看消息或错误,你就会看到相关描述。例如,
      你可以通过验证API检查加密是否正确。
Code
Message
Detail/Action
-1
Signature verification failed
Please check sign method and private key
-1
the payment get by tradeId does not exist
please check the tradeId, the tradeId must get by create payment response
-1
rate not found
the sourceCurrency or targetCurrency is error
-1
Required request is missing
miss request body, please check the api docs and set the body content
-1
Wallet in this currency was not found
the request body of currency not exist or not support currency
-1
Do not repeat the request
Concurrent requests are not supported for create or confirm the same payment
-1
StringIndexOutOfBoundsException
the beneficiary’s idNumber is error
-1
order already exists
have created the payment on xCurrency Hubs side, can not create the same orderNo payment
-1
Error in file operation processing
Beneficiary's accountName should be Simplified Chinese, such as "张三", "李四" etc.
-1
Unsupported binding card
please check the Beneficiary's info, some data is wrong, not the actual data, when change right can resubmit again
-1
Payee account name is wrong
please check the Beneficiary's info, some data is wrong, not the actual data, when change right can resubmit again
-1
wrong database operation
please check the Beneficiary's expireDate, the format should be yyyy-MM-dd
-1
The order is being processed, please do not repeat the operation.
don't request same transfer API twice
-1
Risk control
Do not use the payer to create payment, or can contact xCurrency Hubs to get help
-1
Verification failed, identity information or mobile phone number input was incorrect.
should check the Beneficiary's idNumber or accountName or bank card no is right, when change right can resubmit again
-1
The ID number is incorrectly entered, and the ID number is not standard.
the Beneficiary's idNumber is not right, when change right can resubmit again
-1
Address structuring failed (xxxxxx,xxxx,xxxx)
please try resubmit the payment, will fix this issue, if not contact xCurrency Hubs to get help
  1. Can the same order be called concurrently with the transfer payment api?
    1. No.
  1. Can the beneficiary's accountName be Chinese PinYin?
    1. No, this should be Simplified Chinese, such as "张三", "李四" etc.
  1. When get webhook notify callback, what can do next?
    1. Webhook data
      Action
      {"event":"payment","id":"{tradeId}","status":"awaiting_transfer"}
      can call anync confirm API
      {"event":"payment","id":"{tradeId}","status":"transferring","message":"The order is being processed, please do not repeat the operation."}
      no action
      {"event":"payment","id":"{tradeId}","status":"completed", "sourceAmount": 100, "targetAmount": 100}
      transfer success and completed
      {"event":"payment","id":"{tradeId}","status":"awaiting_transfer","message":"The order is being processed, please do not repeat the operation."}
      same status of awaiting_transfer, but with error message, no action
      {"event":"payment","id":"{tradeId}","status":"failed","message":"The payment cannot be transferred, the payment status is not awaiting_transfer"}
      no action, this happen by you call anync confirm API on wrong payment status, this may be happen few
      {"event":"payment","id":"{tradeId}","status":"failed","message":"{error message}"}
      no action, will auto cancel the fail payments
      {"event":"payment","id":"{tradeId}","status":"rejected","message":"idNumber had exist or other error message"}
      can contact xCurrency Hubs to get to solve it or cancel the payment

Powered by Notaku