Skip to main content

Merchant Registration

The very first step is to create a merchant entity in the FirstPay system.

When registering, you need to specify the postback_url.

Creating a Postback URL

POST requests from the FirstPay system will be sent to this URL. Additionally, when creating a payment, you can specify a postback URL as a parameter.

The interaction workflow is as follows:

  1. FirstPay receives a payment request from the merchant.
  2. FirstPay validates the payment.
  3. Upon payment confirmation, FirstPay sends a POST request to the postback_url. If a URL was provided as a parameter during payment creation, the request is sent there. Otherwise, the request is sent to the URL registered on the merchant’s page.
  4. FirstPay expects a response with "status code 200" from the URL. If the response code is anything other than 200, FirstPay will continue to send repeated requests periodically.

More details about the interaction contract with the postbackl url can be found in the Handling Postback Requests section.