Notes
Last updated
Last updated
The Yuansfer APIs return the following codes in the ret_code parameter :
The merchants create an IPN listener page on their website and then specify the URL of the listener page in the request body. Yuansfer API then sends notifications of all transaction-related events to that URL. When customers pay for goods or services, the API sends a secure FORM POST containing payment information (IPN messages), to the URL. The IPN listener detects and processes IPN messages using the merchant processes. The IPN listener page contains a custom script or program that waits for back-end messages, validates success status, and then passes them to various back-end applications for processing. The IPN listener has to response 'success' string (not quote) to Yuansfer, otherwise, Yuansfer will send the async payment notification 8 times. IPN is not synchronized with actions on your website. Internet connectivity is not always 100% reliable and IPN messages can be lost or delayed. The IPN service automatically resends messages until the listener acknowledges them. The service resends messages up to 8 times in 2 hours.
Auto-debit will send a success notification. This asynchronous callback notification will contain parameters such as autoDebitNo, autoReference, vendor, time, note, and verifySign.
When the merchant’s system receives a callback from the Yuansfer system, it is recommended that the merchant’s system validates the parameters in the callback information by using the verifySign, to ensure that the data has not been tampered with.
Yuansfer returns the following parameters in callbacks (including IPN).
Yuansfer's working timezone is UTC +8.
Parameter
Type
Description
transactionNo
string
The Transaction ID in the Yuansfer system.
reference
string
The Invoice Number of the transaction in the merchant’s system.
originalTransactionNo
string
The ID of the original transaction in the Yuansfer system.
merchantNo
string
Merchant ID
storeNo
string
Store ID
storeAdminNo
string
Store Admin ID
amount
number
The transaction amount.
refundAmount
number
The refund amount.
voidAmount
number
The void or cancel amount.
transactionType
string
The possible transaction type values are "payment","refund","void".
transactionStatus
string
The status of the transaction
currency
string
The supported transaction currency are "USD", "CNY", "PHP", "IDR", "KRW", "HKD", "THB", "MYR", "GBP", "BDT", "PKR".
settleCurrency
string
The supported settlement currency are "USD", "GBP".
createTime
string
The date and time when the authorization was created.
Format : "yyyy-MM-dd HH:mm:ss".
paymentTime
string
The date and time when the payment was processed.
Format : "yyyy-MM-dd HH:mm:ss".
exchangeRate
number
The exchange rate between USD and CNY.
vendor
string
The possible payment channels are "alipay", "wechatpay".
Return Code
Meaning
000000
System Error
000010
API Version Error
000020
Parameter Null Error
000021
Parameter No Related Information
000022
Parameters Do Not Match
000023
Parameter Value Error
000030
No Rights / Access Denied
000040
Transaction Status Error
000080
Supplier System's Error
000100
Success
Status
Meaning
init
A new transaction is created, but not sent to the payment channel.
dealing
Dealing with the payment.
success
The transaction has been successfully processed.
failed
The transaction has failed.
pending
Waiting for the payment confirmation.
closed
The payment channel was setup, but the customer didn’t continue to complete payment action and automatically closed after a certain period.
Status
Description
success
Funds have been credited to the recipient’s account
pending
Your payout request was received and will be processed
failed
This payout request has failed, so funds were not deducted from the sender’s account
returned
The recipient has not claimed this payout, so the funds have been returned to your account
refunded
This payout request was refunded
reversed
This payout request was reversed
unclaimed
The recipient for this payout does not have a PayPal account. A link to sign up for a PayPal account was sent to the recipient
onhold
This payout request is being reviewed and is on hold
blocked
This payout request has been blocked
Parameter
Type
Description
autoDebitNo
string
Unique ID of auto debit in Yuansfer's system.
autoReference
string
Unique ID of auto debit in the merchant's system.
autoStatus
string
The possible values are "consulted", "revoked",
----consulted: Indicates that the user agrees to authorize.
----revoked: Indicates that the authorization cancellation initiated from the merchant or wallet app succeeded.
vendor
string
The possible payment channels are "gcash", "kakaopay", "alipay", "alipay_hk", "dana", "truemoney", "tng", "easypaisa", "bkash".
time
string
The date and time when the authorization was created
Format : "YYYYMMDDHHMMSS".
note
string
The payment note.
reason
string
The reason why the authorization is canceled.
Parameter
Type
Description
transactionNo
string
The Transaction ID in the Yuansfer system.
status
string
The status of the transaction
amount
string
The transaction amount.
currency
string
The supported transaction currency are "USD", "CNY", "PHP", "IDR", "KRW", "HKD", "THB", "MYR", "GBP", "BDT", "PKR"..
settleCurrency
string
The supported settlement currency are "USD", "GBP".
time
string
The date and time when the authorization was created
Format : "YYYYMMDDHHMMSS".
reference
string
The Invoice Number of the transaction in the merchant’s system.
vendorId
string
Providers Transaction ID
note
string
The payment note.
verifySign
string
The parameter signature.