Docs
Docs
  • 简体中文
  • English
Docs
  • 简体中文
  • English
  • Docs

    • Common Conventions
    • Collection / Payin
    • Payout / Remittance
    • Account Balance
    • Transaction Query
    • Async Notification (Collection / Payout)
    • Signature
    • Account (Acct)
    • Special Instructions

Async Notification (Collection / Payout)

To simplify integration, the async notification payload for collection and payout is the same. Pay special attention to the sts field: the status values differ between payout and collection.

Notification Parameters
FieldKeyTypeSignedExampleDescription
Merchant IDmeridstringYes10085Merchant ID assigned by the platform (not the login account).
Order No.snstringYessn1234556Platform order number.
Merchant Order No.tnostringYestnoMerchant order number.
AmountamtstringYes126.35Order amount.
StatusstsstringYessuccessCollections notify only on success. Payouts may also notify with failure statuses.
Create TimectmstringYes2000-01-01 10:10:10Order creation time.
Extra DataextrastringYesSD1564654567715547Extra data.
Notify URLnotify_urlstringYeshttp://www.baidu.com
Extend DataextendstringNowithdraw fail, account blockedExtension info (e.g. payout failure reason).
1) This field is NOT included in the signature.
2) Enable “Add extend in callback” in Merchant Console → Personal Center → “API Extension Settings”.
SignaturesignstringNoc8bbeab3ffb1....Signature.

After verifying the notification, respond with HTTP status 200 and utf-8, and return plain text success.

Examples

php

header("Content-Type: text/plain; charset=utf-8");
echo "success";

java

response.setContentType("text/plain; charset=utf-8");
response.getWriter().write("success");

.NET

Response.ContentType = "text/plain; charset=utf-8";
await Response.WriteAsync("success");

GO

w.Header().Set("Content-Type", "text/plain; charset=utf-8")
w.Write([]byte("success"))
Prev
Transaction Query
Next
Signature