For the complete documentation index, see llms.txt. This page is also available as Markdown.

Refund post request

Collection refunds might not go as planned as such you can request that the funds be returned to the customer. When the refund request is made, we reimburse the customer the exact or a fraction of the amount that was paid in the original transaction request. Each transaction indicates this via support_partial_refund which is sent when a payment request is made or via the webhook notification. if a fraction of the amount can be sent support_partial_refund will be true During the refund request processing, the funds are debited from your respective currency merchant account wallet. A notification about the status of the refund will be set to the set webhook URL set under your merchant account API tokens.

Live

POST https://kitegateway.com/v1/collections/refund

Sandbox

POST  https://sandbox.kitegateway.com/v1/collections/refund

Request

Header

Value

Required

Content-Type

application/json

YES

Accept

application/json

YES

Authorization

JWT ***

YES

Request

Parameter Name

Type

Description

Required

kitegateway_reference

string

The Kitegateway reference of the transaction to refund. This is usually included in the API request responses or IPN's

YES

amount

integer

(Optional) Specify for a partial refund. The amount should be less or equal to the transaction amount in the previous transaction

NO

Parameter Name

Type

Description

id

kitegateway_reference

string

The Kitegateway reference of the transaction to refund. This is usually included in the API request responses or IPN's

transaction_amount

integer

The amount of money to refund

transaction_currency

string

The currency being refunded

transaction_fee

integer

Fee charged

total_debit

integer

Amount debited from wallet

payment_method

string

The payment method that was used during collection

merchant_reference

string

The reference provided by the merchant

collection_reference

string

The kitegateway collection reference that was made prior to this refund

transaction_status

string

One of either PENDING, COMPLETED

Last updated