Void

Cancel a card transaction before it has been settled.

Endpoint


Method	`POST`
Path	`/cards-refund/reverse`
Sandbox	`https://sandbox.simpaisa.com/cards-refund/reverse`

Headers

Header	Value
`client-id`	Your Client ID (e.g. `YOUR_CLIENT_ID`)
`Content-Type`	`application/json`
`merchantId`	Your unique merchant ID (e.g. `YOUR_MERCHANT_ID`)
`mode`	`cards`
`region`	`PK`
`version`	`V5`

Request Body

Parameter	Required	Description
`request.apiOperation`	Yes	`VOID` to cancel the transaction
`request.reference`	Yes	Reference of the transaction to void
`request.transactionDate`	Yes	Original transaction date (`YYYY-MM-DD`)
`request.amount`	No	Amount to void
`request.additionalParameter.additionalString1`	No	Additional string parameter
`request.additionalParameter.additionalString2`	No	Additional string parameter
`request.additionalParameter.additionalString3`	No	Additional string parameter
`request.additionalParameter.additionalInteger1`	No	Additional integer parameter
`request.additionalParameter.additionalInteger2`	No	Additional integer parameter
`request.additionalParameter.additionalDate`	No	Date parameter (`YYYY-MM-DD`)
`signature`	Yes	RSA signature of the request body

Response Body

Parameter	Description
`response.action_id`	Unique action ID for the void request
`response.status`	e.g. `Declined`, `Refunded`
`response.response_code`	Outcome code (e.g. `0` for success)
`response.response_summary`	e.g. `Transaction Refunded Successfully.`
`response.reference`	Reference of the original transaction
`response.RefundReferenceNumber`	Reference number for the voided transaction
`signature`	RSA signature of the response body

Sample Request

curl --location 'https://sandbox.simpaisa.com/cards-refund/reverse' \
--header 'client-id: YOUR_CLIENT_ID' \
--header 'merchantId: YOUR_MERCHANT_ID' \
--header 'mode: cards' \
--header 'region: PK' \
--header 'version: V5' \
--header 'Content-Type: application/json' \
--data-raw '{
    "request": {
        "apiOperation": "VOID",
        "reference": "haf261",
        "amount": "9",
        "transactionDate": "2025-02-06",
        "additionalParameter": {
            "additionalString1": "drhehxnndngtdtdhthjjy",
            "additionalString2": "string_value_2",
            "additionalString3": "string_value_3",
            "additionalInteger1": 12345,
            "additionalInteger2": 67890,
            "additionalDate": "2024-09-13"
        }
    },
    "signature": "YOUR_SIGNATURE"
}'

Sample Response

{
  "response": {
    "apiOperation": "VOID",
    "action_id": "act_59f6fe8ab8264bb4a5cc2390ba",
    "status": "Refunded",
    "response_code": "0",
    "response_summary": "Transaction Refunded Successfully.",
    "reference": "haf261",
    "RefundReferenceNumber": "2025020611273607100030",
    "additionalParameter": {
      "additionalString1": "drhehxnndngtdtdhthjjy",
      "additionalString2": "string_value_2",
      "additionalString3": "string_value_3",
      "additionalInteger1": 12345,
      "additionalInteger2": 67890,
      "additionalDate": "2024-09-13"
    }
  },
  "signature": "YOUR_SIGNATURE"
}

Endpoint​

Headers​

Request Body​

Response Body​

Sample Request​

Sample Response​

Endpoint

Headers

Request Body

Response Body

Sample Request

Sample Response