logo

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

Powered by Notaku