Where to find the notifications

 

All the required information in the transaction is sent to the notification URL provided. A sample of the objects is given below.

 

To receive notifications on the configured URL, your URL must end with /v1/notification.

 

Example: “https://test.com/v1/notification”

 

Receive Notification Request

 

The code provided is a sample of a notification after a transaction. In the response you will be able to find all the required information regarding the transaction.

 

If your endpoint does not return a 2XX HTTP status code, iSignthis will attempt to retry with additional POST(s).

 

The notification will be attempted in the following intervals until such response is received: 5 seconds, 1 minute, 1 hour, 6 hours, 12 hours, 1 day and finally one more day.

 

FieldTypeDescription
id“String”Unique response identification code.
recurring_transactionBooleanWhether the transaction was a recurring operation or not
event“String”Event name of the notification.
payment_provider_responsesArrayInformation about payments. Click here for more information
payment_amountObjectSettled payment amount
Sample Notification
{
  "id": "700f1b71-3d47-47c2-8c62-b0a24d909875",
  "uid": "700f1b71-3d47-47c2-8c62-b0a24d909875",
  "recurring_transaction": false,
  "event": "payment_success",
  "screen_entities": [],
  "outstanding_tasks": [],
  "payment_provider_responses": [
    {
      "operation_successful": false,
      "reference_code": "CT001-00001",
      "response_id": "Smith",
      "status_code": "2020-05-05T10:23:41.8833434Z",
      "manual_reconciliation": false
    }
  ],
  "payment_amount": {
    "currency": "EUR",
    "amount": 100
  }
}