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.

Field Type Subtype Description
id “String” Unique response identification code.
recurring_transaction Boolean Whether the transaction was a recurring operation or not
event “String” Event name of the notification.
payment_provider_responses Array Information about payments. Click here for more information
boolean operation_succesful Indicates whether the operation was successful or not.
String provider_name The name of the Payment Provider.
String reference_code A unique reference code for the transaction.
String provider_reference_code The identifier issued by the payment provider for this operation.
String response_id The response identifier.
String status_code The status code returned from payment provider.
String external_correlation_id External correlation ID for SIIN notifications
String details Transaction details
String manual_reconciliation
payment_amount Object Settled payment amount
String Currency ISO4217 currency (alpha) code for payment.
String Amount The amount in the smallest currency unit (e.g. cents if using Euros).
Sample Notification
  "id": "96bc652e-9c67-462d-a678-5d196e120b2d",
  "uid": "96bc652e-9c67-462d-a678-5d196e120b2d",
  "recurring_transaction": false,
  "event": "payment_success",
  "screen_entities": [],
  "payment_provider_responses": [
      "operation_successful": false,
      "provider_name": "Test Merchant",
      "reference_code": "CT001-0932112",
      "provider_reference_code": "CY66904000010004100014401000",
      "response_id": "Thompson",
      "status_code": "2020-11-13T13:12:56.8336433Z",
      "external_correlation_id": "4b292023-8b0b-4e75-98b4-5f07273ef06e",
      "details": "Transaction_details",
"manual_reconciliation": false
  "payment_amount": {
    "currency": "EUR",
    "amount": 100000