Void Authorized Payments

General
1

Hi Maya team,

I’m trying to void an authorized payment, but I can’t find any documentation for doing this in Payments API v1.

Currently, I’m using the Checkout / Payments v1 API, and I can successfully capture a payment with this endpoint:
POST /payments/v1/payments/{paymentId}/capture

Is there a way to void an authorized payment in v1? Or do I need to wait for the authorization to expire automatically?

Thanks in advance for any guidance!

2

To void an authorized payment, you can send a void request to release the on-hold amount from your customer’s account/card. You can only void an AUTHORIZED authorization or as long as: 1. Authorization is not past the hold period (not in CAPTURE_HOLD_EXPIRED state), 2. No capture payment is done yet (not in CAPTURED or DONE state), 3. Authorization is not in the VOID state. If an authorization has already been voided, succeeding cancellation attempts will fail.

For Sandbox concerns and other technical implementation inquiries, please get in touch with us via:

  • Sandbox Health Page: Check real-time service status updates.
  • Maya Developer Hub Service Desk: File
    a ticket in Sandbox.

To Know More:

We value your input and would love to hear your insights. Please submit you feedback here.

3

Hi @nik,

To void an authorized payment (not yet captured), it should comply with the following conditions:

  • Authorization intent is still in AUTHORIZED state

  • Authorization hold has not expired (CAPTURE_HOLD_EXPIRED not reached)

  • No capture intent exists for that authorization

Then you can void a Checkout payment through the Maya Business Manager / Maya Manager 1.0 transaction dashboards (from the list of transactions), or via API.

For the APIs, this needs to be explicitly enabled for your account. Another thread mentioned this: Api Documentation for payment gateway integration for Philippines client - #3 by genson.cerezo

You may use this as a reference on how to handle voiding and refund for auth and capture for Checkout: Managing Voids and Refunds in Maya Checkout