Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.monxa.co/llms.txt

Use this file to discover all available pages before exploring further.

The Payment Cancellation API allows merchants to cancel payments that are still in the “processing” stage, giving you full control to stop transactions before they reach a final status. This is particularly useful for scenarios such as:
  • Managing inventory when an item is out of stock.
  • Enforcing time-sensitive payment rules.
  • Applying custom business logic to align with operational policies or customer requests.
By providing this capability, the API helps merchants maintain transaction control, streamline operations, and improve the customer experience.

​
How to Cancel a Payment

Use the following endpoint to cancel a payment:
MethodEndpoint
GEThttps://api.monxa.dev/v1/payments/{id}/cancel
Replace {id} with the payment_id of the transaction you want to cancel.
Note: You can only cancel a payment if its status is still processing
After calling the API, the response will indicate the final status of the transaction. If the status is cancelled, the payment has been successfully cancelled.Example Response:
{
  "data": {
    "id": "pay_ohXLNm2fPw6868",
    "status": "cancelled",
    "order_id": "ord_Dg0Dz9wwKP1602",
    "created_at": "2020-11-19T22:09:48Z",
    "updated_at": "2020-11-26T20:02:24.561169Z"
  }
}