Skip to main content

Notification reference

Revup sends notifications to merchants to report changes in the status of a transaction. To receive these notifications, you must define the URL to which they should be sent by default in the Revup backoffice. You can also provide a notification URL during order creation, if you need to dynamically configure this URL for some specific cases. Please take into account the following:

  • The method used to send notifications is a HTTPS web server POST.
  • The body of the message will be in application/json format.
  • If the request to the provided URL returns any status code different from 200 or takes more than 20 seconds, there will be a retry later.
  • Some PSPs perform automatic refunds in case of fraud or suspicious payment. When the PSP sends such notifications to Revup, we will process the refund then forward the notification to the merchant using the same format as any other refund. The same applies to the refunds executed from the Revup backoffice.
  • Some notifications examples are provided below, please refer to the field appendix for detailed information about the information that Revup notifications may contain.

NOTIFICATION EXAMPLE - PAYMENT SUCCESSFUL​

{
   "orderId": "177fb1ba-7dfe-4f51-b17b-7da7163870ce",
   "transactionId": "99350098-66e0-428e-ba09-da38dce44d4d",
   "transactionType": "payment",
   "transactionStatus": "success",
   "notificationDate": "2020-03-09T15:35:11.004Z",
   "money": {
      "amount": 29.95,
      "currency": "EUR"
   }
}

NOTIFICATION EXAMPLE - REFUND FAILED​

{
   "orderId": "177fb1ba-7dfe-4f51-b17b-7da7163870ce",
   "transactionId": "99350098-66e0-428e-ba09-da38dce44d4d",
   "transactionType": "refund",
   "transactionStatus": "failed",
   "notificationDate": "2020-03-09T15:35:11.004Z",
   "money": {
      "amount": 1.95,
      "currency": "EUR"
   },
   "error": {
      "code": "0102",
      "message": "Authorization Failed"
   }
}

NOTIFICATION EXAMPLE - PAYMENT WAITING FOR USER INTERACTION​

{
   "orderId": "f5b207a0-237e-4eee-b4d3-f4cc5e8ad37e",
   "transactionId": "cb6dea98-57ea-4cc6-9ead-7df499d08f8a",
   "transactionType": "payment",
   "transactionStatus": "waiting_user_interaction",
   "notificationDate": "2021-02-03T15:10:57Z",
   "money": {
      "amount": 1.99,
      "currency": "USD"
   },
   "action": {
      "url": "https://www.acsserver.com/redirect",
      "method": "GET"
   }
}

NOTIFICATION EXAMPLE - CHARGEBACK SUCCESSFUL​

{
   "orderId": "177fb1ba-7dfe-4f51-b17b-7da7163870ce",
   "transactionId": "99350098-66e0-428e-ba09-da38dce44d4d",
   "transactionType": "chargeback",
   "transactionStatus": "success",
   "notificationDate": "2020-03-09T15:35:11.004Z",
   "money": {
      "amount": 29.95,
      "currency": "EUR"
   },
   "chargebackInfo": {
      "reasonCode": "10.1",
      "category": "Fraud",
      "description": "Chip Liability Shift"
   }
}

RDR EXAMPLE - SUCCESSFUL​

{
    "orderId": "db9b9cc9-a264-41a4-905d-3fe6e76c453f",
    "transactionId": "9370e59d-ca1d-42e9-ac80-406d9b1437d7",
    "transactionType": "rdr",
    "transactionStatus": "success",
    "notificationDate": "2024-10-23T04:02:07.441814Z",
    "money": {
        "amount": 129.00,
        "currency": "USD"
    }
}