Notes

Transaction Object

Response return code

The Yuansfer APIs return the following codes in the ret_code parameter :

Transaction status

Payouts transaction status

Instant Payment Notification

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.

Callback Parameters

Auto-Debit Transaction Notifications

Auto-debit will send a success notification. This asynchronous callback notification will contain parameters such as autoDebitNo, autoReference, vendor, time, note, and verifySign.

Payment Transaction Notifications

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 Timezone

Yuansfer's working timezone is UTC +8.

Last updated