API Docs
/
No Results Found
Refunds

Refunds

A refund object enables you to manage your refunds. Refunds can be made by direct payment to the respective customer or through credits.

Attribute

refund_id
string
Unique ID generated for a refund made.
date
string
The date on which refund is made.
amount
double
The amount to be refund.
description
string
A small description about the refund.
reference_number
string
Reference number for the refund made. A custom string can also be set as the reference number.
refund_mode
string
Mode through which refund is made. This can be check, cash, creditcard, banktransfer, bankremittance, autotransaction or others.
status
string
Status of the refund made. This can be either success or failure.
customer_id
string
Customer ID of the customer to whom the refund is to be made.
email
string
Email address of the customer.
creditnote
object
It contains details of the credit note for which the refund has to made. Each object contains creditnote_id, creditnote_number, date, amount, refund_amount and balance_amount.
Show Sub-Attributes arrow
creditnote_id
string
Credit note ID of the credit note involved in this refund.
creditnote_number
string
Credit note number (starts with CN) of the credit note.
date
The date on which the credit note is raised.
amount
The total amount for which the credit note is raised.
refund_amount
double
The amount for which the refund is to be made.
balance_amount
double
Unused credits.
autotransaction
object
If the refund mode is autotransaction, autotransaction information will be displayed in the autotransaction object. It contains autotransaction_id, payment_gateway, gateway_transaction_id, card_id, last_four_digits, expiry_month and expiry_year.
Show Sub-Attributes arrow
autotransaction_id
string
Auto-transaction ID generated for the payment made.
payment_gateway
string
Name of the payment gateway associated with payment.
gateway_transaction_id
string
Transaction ID of the gateway associated with payment.
gateway_error_message
string
Gateway error for a failed transaction.
card_id
string
Card ID of the card.
last_four_digits
integer
Last four digits of the card.
expiry_month
integer
Expiry month of the card.
expiry_year
integer
Expiry year of the card.
currency_code
string
Customer's currency code. Refunds will be made in the customer's currency.
currency_symbol
string
The currency symbol of the currency chosen for the customer.

Example

{ "refund_id": "90300000081385", "date": "2016-06-05", "amount": "20", "description": "Refund for discount Offer", "reference_number": "INV-384", "refund_mode": "autotransaction", "status": "success", "customer_id": "903000000000099", "email": "benjamin.george@bowmanfurniture.com", "creditnote": { "creditnote_id": "90300000081375", "creditnote_number": "CN-26", "date": "2016-06-05", "amount": 20, "refund_amount": 20, "balance_amount": 0 }, "autotransaction": { "autotransaction_id": "9030000081373", "payment_gateway": "Paypal Payflowpro", "gateway_transaction_id": "B70E6CCF288D", "gateway_error_message": "Gateway error for a failed transaction.", "card_id": "903000079226", "last_four_digits": 1111, "expiry_month": 9, "expiry_year": 2030 }, "currency_code": "USD", "currency_symbol": "$" }

Refund a credit note

Refund is made on the credit note.
oauthscope : ZohoSubscriptions.creditnotes.CREATE

Arguments

amount
double
(Required)
The amount to be refund.
description
string
A small description about the refund.

Request Example

Click to copy
$ curl https://subscriptions.zoho.com/api/v1/creditnotes/{creditnote_id}/refunds -X POST -H "X-com-zoho-subscriptions-organizationid: 10234695" -H "Content-Type: application/json;charset=UTF-8" -H "Authorization: Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f" -d '{"field":"value","field":"value"}'

Body Parameters

Click to copy
{ "amount": "20", "description": "Refund for discount Offer" }

Response Example

{ "code": 0, "message": "The refund information has been saved.", "refund": { "refund_id": "90300000081385", "date": "2016-06-05", "amount": "20", "description": "Refund for discount Offer", "reference_number": "INV-384", "refund_mode": "autotransaction", "status": "success", "customer_id": "903000000000099", "email": "benjamin.george@bowmanfurniture.com", "creditnote": { "creditnote_id": "90300000081375", "creditnote_number": "CN-26", "date": "2016-06-05", "amount": 20, "refund_amount": 20, "balance_amount": 0 }, "autotransaction": { "autotransaction_id": "9030000081373", "payment_gateway": "Paypal Payflowpro", "gateway_transaction_id": "B70E6CCF288D", "gateway_error_message": "Gateway error for a failed transaction.", "card_id": "903000079226", "last_four_digits": 1111, "expiry_month": 9, "expiry_year": 2030 }, "currency_code": "USD", "currency_symbol": "$" } }

Refund a payment

A new credit note is created for the amount to be refund. Refund is then made for the credit note.
oauthscope : ZohoSubscriptions.payments.CREATE

Arguments

amount
double
(Required)
The amount to be refund.
description
string
A small description about the refund.

Request Example

Click to copy
$ curl https://subscriptions.zoho.com/api/v1/payments/{payment_id}/refunds -X POST -H "X-com-zoho-subscriptions-organizationid: 10234695" -H "Content-Type: application/json;charset=UTF-8" -H "Authorization: Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f" -d '{"field":"value","field":"value"}'

Body Parameters

Click to copy
{ "amount": "20", "description": "Refund for discount Offer" }

Response Example

{ "code": 0, "message": "The refund information has been saved.", "refund": { "refund_id": "90300000081385", "date": "2016-06-05", "amount": "20", "description": "Refund for discount Offer", "reference_number": "INV-384", "refund_mode": "autotransaction", "status": "success", "customer_id": "903000000000099", "email": "benjamin.george@bowmanfurniture.com", "creditnote": { "creditnote_id": "90300000081375", "creditnote_number": "CN-26", "date": "2016-06-05", "amount": 20, "refund_amount": 20, "balance_amount": 0 }, "autotransaction": { "autotransaction_id": "9030000081373", "payment_gateway": "Paypal Payflowpro", "gateway_transaction_id": "B70E6CCF288D", "gateway_error_message": "Gateway error for a failed transaction.", "card_id": "903000079226", "last_four_digits": 1111, "expiry_month": 9, "expiry_year": 2030 }, "currency_code": "USD", "currency_symbol": "$" } }

Retrieve refund details

Details of an existing refund.
oauthscope : ZohoSubscriptions.creditnotes.READ

Request Example

Click to copy
$ curl https://subscriptions.zoho.com/api/v1/creditnotes/refunds/{refund_id} -H "X-com-zoho-subscriptions-organizationid: 10234695" -H "Authorization: Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f"

Response Example

{ "code": 0, "message": "success", "refund": { "refund_id": "90300000081385", "date": "2016-06-05", "amount": "20", "description": "Refund for discount Offer", "reference_number": "INV-384", "refund_mode": "autotransaction", "status": "success", "customer_id": "903000000000099", "email": "benjamin.george@bowmanfurniture.com", "creditnote": { "creditnote_id": "90300000081375", "creditnote_number": "CN-26", "date": "2016-06-05", "amount": 20, "refund_amount": 20, "balance_amount": 0 }, "autotransaction": { "autotransaction_id": "9030000081373", "payment_gateway": "Paypal Payflowpro", "gateway_transaction_id": "B70E6CCF288D", "gateway_error_message": "Gateway error for a failed transaction.", "card_id": "903000079226", "last_four_digits": 1111, "expiry_month": 9, "expiry_year": 2030 }, "currency_code": "USD", "currency_symbol": "$" } }