Skip to main content

Callback

A callback is a system message that the PagaSul payment platform sends to your system to pass information such as the final payment result.

PagaSul sends callbacks to one of the following URLs:

  • the URL you provide PagaSul with when integrating
  • the URL you pass in the payment_options.callback_url parameter of your payment request — if passed, it overrides the integration URL for that specific payment
HTTP request methodPOST
Request body formatJSON

Callback headers:

HeaderValueDescription
SignaturecalculatedSignature string. Verify it before trusting the body — see Signature generation.
Content-Typeapplication/jsonMedia type of the callback body.

The callback body has the same structure as the synchronous payment response. For the full field list and examples, see the API Reference; for possible status and result_code values, see Payment statuses and result codes.