API REFERENCE

Brazil · Collection webhook

Endpoint, parameters and examples for Brazil: Collection webhook.

Notification destination#

POSTpay_notifyurl

application/x-www-form-urlencoded

Parameters#

Field	Requirement	Signed	Description
`memberid`	Required	Yes	Merchant number shown in the panel, not the internal user ID.
`orderid`	Required	Yes	Original merchant order ID.
`transaction_id`	Required	Yes	Platform order or transaction ID.
`amount`	Required	Yes	Requested principal in BRL, excluding fees. Verify the original received amount string.
`datetime`	Required	Yes	Notification generation time: yyyyMMddHHmmss, e.g. 20261024120000.
`returncode`	Required	Yes	Successful collection is the string "00".
`sign`	Required	No	32-character uppercase MD5 signature; exclude this field from signing.
`attach`	Optional	No	Additional data, returned as attach and excluded from collection signatures. Use type to request JSON output.

Examples#

Notification example

{
  "memberid": "10000",
  "orderid": "DEMO_PAYIN_001",
  "transaction_id": "DEMO_PLATFORM_PAYIN",
  "amount": "100.00",
  "datetime": "20261024120000",
  "returncode": "00",
  "sign": "CALCULATE_WITH_YOUR_APIKEY",
  "attach": "DEMO_ATTACH"
}

Notification example

HTTP/1.1 200 OK
Content-Type: text/plain; charset=UTF-8

OK

Notification example

fail

Signing & result handling#

Verify sign before processing. Match merchant, order and amount; apply the result idempotently.

Open signing guide

Return after successful processing

OK