Emits when a payment has been completed.

POST https://webhook.example.com

Instant Payment Notifications (IPNs, also known as a webhook or callback) are used to quickly notify when a payment has been completed. When a payment is completed, the webhook will send a post request to the destination url configured on the Madora Payment Account. Responses to this webhook are ignored.

Body

  • paymentIdentifier string Required

    Unique identifier for the created payment.

  • status string Required

    Unique identifier for the created payment. Successful transactions will be marked as completed. Transactions that have failed due to technical reasons will be marked Error, while transactions that were flagged and denied by our Anti-Money Laundering program will be marked as AMLError. Transactions that are flagged will always automatically return money to the user.

    Values are Waiting, Cancelled, Error, AMLError, or Completed.

  • isComplete boolean Required

    Simple boolean to determine if a payment has successfully completed.

  • createdDatetime string(date-time) Required

    Datetime of when the payment was first created, in the format: uuuu-MM-dd'T'HH:mm:ss

  • orderId string

    Optional identifier for the transaction for merchant use. Not used by Madora.

  • Optional description for the transaction for merchant use. Not used by Madora.

POST paymentConfirmation
Request example
{
  "paymentIdentifier": "f390682f-4ded-41d6-adfd-80c54e85d73f",
  "status": "Waiting",
  "isComplete": true,
  "createdDatetime": "2023-05-04T09:42:00+00:00",
  "orderId": "1",
  "orderDescription": "test transaction"
}
Request examples
{
  "paymentIdentifier": "f390682f-4ded-41d6-adfd-80c54e85d73f",
  "status": "Waiting",
  "isComplete": true,
  "createdDatetime": "2024-05-04T09:42:00+00:00",
  "orderId": "1",
  "orderDescription": "test transaction"
}