Skip to main content

Webhook endpoint for payment notifications

POST /webhook-url

Receiving payment notifications from relario PAY API. The merchant needs to implement this HTTP endpoint in their system to receive payment confirmation requests. Requests are authenticated with HMAC authentication, and the HMAC token is placed on the request under the Payment-Signature HTTP header. See section HMAC generation examples for more details about generating and checking the HMAC token.

Request Body required
  • paymentType string

    Possible values: [sms]

    The payment method used by the merchant's customer to buy the virtual goods or service.

  • transactionId string

    Id of the transaction.

  • paymentId number

    Id of the payment.

  • customerId string

    Unique token used by the merchant to identify its customer.

  • productId string

    Unique identifier of the virtual good or service that the merchant is selling.

  • productName string

    Title of the virtual good or service that the merchant is selling.

  • sourcePhoneNumber MSISDN

    Phone number of the customer that will send the SMS messages.

  • destinationPhoneNumber MSISDN

    The phone number that the customer called or sent SMS to, in order to make the payment.

  • initiatedAt int64

    The date and time when the SMS message was sent by the merchant's customer.

Responses

Webhook request successfully received

Loading...