Enum description
Purpose Codes
Enum | Description | Payout Scene |
Salary | Send salary to yourself | C2C |
Family | Send salary to family members | C2C |
Payroll | Wage payments (sender as employment company or payroll company. | B2C |
Goods | Payment for goods | B2B, B2C |
Service | Payment for service | B2B |
Tuition | Tuition fees are usually paid to the school | C2B |
Insurance | It's usually paid to the insurance company | C2B |
Travel | Travel | C2B |
Rent | Usually renting an apartment or office space overseas | C2B |
Living | Students and other special groups need to pay for living expenses overseas | C2B |
Sub Purpose Codes
Purpose | SubPurpose |
Goods | CLOTHES_BAGS_SHOES_CLOTHES |
DAILY_SUPPLIES_AND_COSMETICS | |
ELECTRONICS_AND_HOME_APPLIANCES | |
TOYS_KIDS_BABIES | |
Service | INTERPRETATION_SERVICE |
TRANSLATION_SERVICE | |
HUMAN_RESOURCE_SERVICE | |
ESTATE_AGENCY_SERVICE | |
SOFTWARE_DEVELOPMENT_SERVICE | |
WEB_DESIGN_OR_DEVELOPMENT_SERVICE | |
DRAFTING_LEGAL_SERVICE | |
LEGAL_RELATED_CERTIFICATION_SERVICE | |
ACCOUNTING_SERVICE | |
TAX_SERVICE | |
ARCHITECTURAL_DECORATION_DESIGN_SERVICE | |
ADVERTISING_SERVICE | |
MARKET_RESEARCH_SERVICE | |
EXHIBITION_BOOTH_SERVICE | |
OTHER_SERVICE |
Relationship Codes
Enum | Description |
Self | The remitter sends money to himself. |
Spouse | The remitter sends money to his/her spouse. |
Parent | The remitter sends money to his/her parent. |
Children | The remitter sends money to his/her child. |
Sibling | The remitter sends money to his/her sibling. |
Grandparent | The remitter sends money to his/her grandparent. |
Grandchildren | The remitter sends money to his/her grandchild. |
Employment | The remitter sends money in the context of an employment relationship to an employee. |
ㅤ | ㅤ |
Order Status
Status | Description |
pending_material | Pending for the merchant to complete the upload certification materials |
awaiting_transfer | Pending for transfer. Only in this status can be transferred |
overrule | Due to incomplete materials, the order needs to be resubmitted |
pending | Submitted successfully, processing in xCurency Hubs |
transferring | Remittance in progress |
transferred | The remittance instruction has been executed, but the remittance being credited to the user's account is subject to the bank's final processing. |
completed | Remittance is complete. User has received payment |
failed | Transfer fail, the Cross-Currency Transaction Mode will refund |
rejected | Sender's compliance information is not approved or for risk control reasons, etc. |
canceled | Payment cancelled |
refunded | Payment Refunded |
Support Docs
Enum | Description CN | Description EN | Payout For Personal | Payout For Business | Payout for Tuition |
bill | 缴费单 | Bill | ✅ | ||
offer | 录取通知书 | Offer | ✅ | ||
identification_front | 大陆居民身份证正面 | Mainland Resident Identity Card Front | ✅ | ||
identification_back | 大陆居民身份证反面 | Mainland Resident Identity Card Back | ✅ | ||
ME | 付款人证件 | Payer's ID | ✅ | ||
MC | 结婚证书 | Marriage certificate | ✅ | ||
SIGN | 关系承诺函 | Relationship commitment letter | ✅ | ||
HR | 户口本 | Household register | ✅ | ||
NCOM | 赡养公证书 | Maintenance certificate | ✅ | ||
BC | 出生证明 | Birth certificate | ✅ | ||
EC | 雇佣合同 | Employment contract | ✅ | ||
POIPBE | 收入证明 | Income certificate | ✅ | ||
COI | 在职证明 | Employment certificate | ✅ | ||
RSIBF | 工资流水 | Salary flow | ✅ | ||
TC | 纳税证明 | Tax certificate | ✅ | ||
proforma_invoice | 正式发票 | Official invoice | ✅ | ||
purchase_order | 采购合同 | Purchase contract | ✅ | ||
logistics_material | 物流凭证 | Logistics certificate | ✅ | ||
export_declaration | 出口报关单 | Export declaration form | ✅ | ||
communication_record | 沟通记录 | Communication record | ✅ | ||
beneficiary_id_card | 收款人身份证件 | Beneficiary ID card | ✅ | ||
beneficiary_power_attorney | 收款人授权书 | Beneficiary authorization letter | ✅ | ||
historical_transaction_material | 双方往期交易单据 | Both parties' past transaction documents | ✅ | ||
proof_purchase | 上下游采购订单证明 | Upstream and downstream purchase order certificate | ✅ | ||
other | 其他补充 | Other supplements | ✅ | ✅ | ✅ |
businessLicense | 企业营业执照注册信息 | Business License | ✅ |
Error Code
Status | Description |
1 | Request successful |
-1 | Illegal request. 'message' contains detailed error message |
10001 | Signature check error |
10002 | Appkey error |
10003 | Quote price is expired |
10004 | Params validation failed |
10005 | The payment cannot be transfered, the payment status is not awaiting_transfer |
10006 | Remittance cannot be made outside the time limit |
10007 | Insufficient balance |
10008 | Sender information is not passed by KYC reviewed, the payment will not be created on xCurrency Hubs' side. |
10009 | Transfer fail, if you have any questions, please contact xCurrency Hubs by email |
10010 | Beneficiary's account is abnormal. Please verify the beneficiary account |
10011 | Beneficiary's account is abnormal. The beneficiary's bank system does not support, please try to use other card |
10012 | Beneficiary's account is abnormal. The beneficiary's ID card has expired |
10013 | Beneficiary's account is abnormal. A non-UnionPay card is detected. Please use UnionPay card |
10014 | Beneficiary's account is abnormal. Exceeding bank limits |
10015 | The sender information is abnormal. If you have any questions, please contact xCurrency Hubs by email |
10016 | Risk control |
10017 | Cancel failed, please check the payment status. |
10018 | Invalid Sender ID Expiry Date. |
10019 | Invalid Sender Birthdate. |
10020 | Blacklisted Sender. |
10021 | Invalid Beneficiary ID Expiry Date. |
10022 | Blacklisted Beneficiary. |
10023 | Invalid Beneficiary Birthdate. |
10100 | The order number is duplicated. Ensure that each order number is unique. |
10101 | There was an error with number validation. Ensure that all numeric fields are correctly formatted. |
10102 | The specified transaction mode is incorrect. Verify the transaction mode. |
10103 | The currency used for this transaction mode is incorrect. Ensure that the currency matches the transaction mode requirements. |
10104 | The payment type is invalid. Ensure that the payment type is correct. |
10105 | For full or final payments, the logistics company must be provided. Ensure that the logistics company is specified. |
10106 | For full or final payments, the logistics number must be provided. Ensure that the logistics number is specified. |
10107 | The beneficiary account name must be in all Chinese characters. Verify the account name. |
10108 | The bank account number is invalid. Ensure that the bank account number is correct. |
10109 | The beneficiary ID number is invalid. Verify the ID number. If the ID number is correct, contact support. |
10110 | For company account payments, the beneficiary bank must be specified. Ensure that the beneficiary bank is provided. |
HTTP code 400, the error message list
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 |
FAQ
FAQ
Question
Type
Reply
When using encryption in other languages, how do I verify that the encryption is correct after communicating with the service?
System Docking
You can check the entryption is ok by the verify api or contact us for methods in different languages.
What can I operate the payment with transfer exception
System Docking
Abnormal payments are handled by our staff. You can contact us for further information.
When the response http status code is 400,
body contains the errors or message attribute, what does it mean?System Docking
This is usually error message, just look at the message or errors, you will see the relevant description.
Can the same orderNo be called concurrently with the transfer payment api?
Order
No
When get webhook notify callback, what can do next?
Order
pending_material: Need to provide the docs.
completed: The order has paid.
failed、rejected、canceled： Order remittance failure.
When I check the exchange rate, how long is the rate valid
Fx Rate
5 mins