Void

The request lets you void a transaction that has been previously authorized and is still pending settlement. Voiding a transaction cancels the authorization process and prevents the transaction from being submitted to the processor for settlement.

---

Request

To initiate a void transaction, send a POST request to https://gateway.fortebank.com/transactions/voids with the following parameters:

request object parent_uid required string A UID of the authorization transaction. amount required bigInteger A transaction amount to void in minimal currency units, for example 1000 for $10.00. additional_data object A section with additional transaction data. referer string URL of the resource from which the transaction request is made. Contact the Tech Support Team to check if this parameter is required by your acquirer.

Example of the request

{
  "request": {
    "parent_uid": "1-310b0da80b",
    "amount": 50,
    "additional_data": {
      "referer": "https://example.com/server/cs_post/post.php?order_id=5304380&security=949247&currency=USD"
    }
  }
}

Response

transaction object uid required string A UID of the processed transaction. status required string A status of the processed transaction. message required string A processing result message corresponding to the processing code (code). type required string A transaction type. smart_routing_verification object A section of parameters of Smart Routing verification results. status string Smart Routing check status for the transaction. receipt_url required string A transaction receipt URL. additional_data object A section of detailed information about the transaction. referer string URL of the resource from which the transaction request is made.

Example of the response

{
  "transaction": {
    "uid": "22e47158-6b75-4098-9fc1-6a2e60521002",
    "status": "successful",
    "amount": 460,
    "currency": "EUR",
    "type": "void",
    "message": "Successfully processed",
    "test": true,
    "created_at": "2024-04-02T12:38:02.775Z",
    "updated_at": "2024-04-02T12:38:10.892Z",
    "paid_at": "2024-04-02T12:38:10.698Z",
    "manually_corrected_at": null,
    "parent_uid": "295b9b6d-444d-4636-b31c-a7e8b374805c",
    "receipt_url": "https://backoffice.fortebank.com/customer/transactions/22e47158-6b75-4098-9fc1-6a2e60521002/a203afa8029b646de18985b933b5dce75178c77b8d09a7e975ade07d5cab9e16?language=en",
    "status_code": null,
    "mute_notifications": null,
    "id": "22e47158-6b75-4098-9fc1-6a2e60521002",
    "smart_routing_verification": {
      "status": "successful"
    },
    "void": {
      "message": "Void was approved",
      "ref_id": "8889913",
      "rrn": null,
      "auth_code": null,
      "bank_code": null,
      "gateway_id": 3208,
      "status": "successful"
    },
     "additional_data": {
          "referer": "https://example.com/server/cs_post/post.php?order_id=5304380&security=949247&currency=USD"
    }
  }
}