Refund implementation

General
1

As a developer how can I implement refund for the payment made via maya checkout? Which API to hit and how to get the ids to pass for that API call?

2

To implement a refund for a payment made via Maya Checkout, follow these steps:

  1. Retrieve the payment ID or request reference number of the original transaction using the Retrieve Payment via ID or Retrieve Payment via Request Reference Number API.
  2. Call the Refund API with the payment ID and other required parameters.

Example:

  • Transaction date: Jan 6, 2022, 9:00 AM GMT+8
  • Eligible for Refund: Jan 7, 2022, 12:00 AM (GMT+8) up to 180 days after

For more details, refer to the Managing Voids and Refunds in Maya Checkout guide.

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

What are the Api endpoints for refund and void for Maya checkout?

4

Hello @FaizanAhmad,

Refunds for payments made via Maya Checkout are supported, but this feature is not enabled by default and requires additional approvals.

Here’s how it works:

  • The Refund API is a controlled feature. Merchants must request activation through their Maya Relationship Manager. This process typically includes internal reviews and the execution of required NDAs.
  • The Refund API documentation and endpoint details are only shared after the request has been approved and the necessary agreements are in place.
  • After access is granted:
    • You will be able to use the Payment ID from a successful Maya Checkout transaction as the primary reference for initiating a refund.
    • The exact API endpoint, required request fields, and supported refund scenarios (full or partial) will be outlined in the approved documentation.

We recommend coordinating with your Maya Relationship Manager to start the enablement process. Once approved, the documentation will be provided to complete the refund integration.