Skip to main content

Refunds

Este endpoint manipula los refunds o reembolsos generados desde tu cuenta.

Crear un reembolso​

Sólo es posible reembolsar el 100% del monto de una transacción satisfactoria, siempre y cuando ésta transacción no haya sido depositada a tu cuenta de banco aún. Una vez iniciado, un reembolso no se puede cancelar.

También puedes reembolsar una transacción directamente desde la Consola.

Endpoint: POST /v1/refunds/

Fields:

ParameterDescriptionTypeRequired
amountMonto del reembolsostringtrue
charge_idIdentificador del Charge en cuestiónstringtrue
reasonduplicate, fraudulent o requested_by_customerstringtrue
await gpApi.charges.create({
amount: 90.32,
description: 'Plan 1 service charge',
entity_description: 'Plan 1',
currency: 'usd',
credit_card_number: 4242424242424242,
credit_card_security_code_number: 123,
exp_month: 11,
exp_year: 2020
})

Retorna:

{
"refund_id": "1BiPhgCqnAMsdzqhvCTntF7aD",
"charge_id": "1BSt6hCqnAMAasd3vMGiBxOWe",
"amount": "10.99",
"currency": "usd",
"reason": "requested_by_customer",
"status": "succeeded",
"test": true
}

Listar los reembolsos​

Este endpoint devuelve todos los reembolsos generados siempre y cuando ésta transacción no haya sido depositada a tu cuenta de banco aún.

HTTP Request: GET https://api.4geeks.io/v1/refunds/

.

Retorna:

[
{
"refund_id": "1BiOrQCqNertMqhvvUMhJajE",
"charge_id": "1BSt5sCqnAMAMqhvd871C1Vl",
"amount": "10.00",
"currency": "usd",
"reason": "duplicate",
"status": "succeeded",
"test": true
},
{
"refund_id": "1BiPDoCqnNerAMqhvSzxyFXl2",
"charge_id": "1BSt5sCqnAMAMqhvd871C1Vl",
"amount": "40.00",
"currency": "usd",
"reason": "fraudulent",
"status": "succeeded",
"test": true
},
{
"refund_id": "1BiPeNCqnANerMqhvc4QUDeeK",
"charge_id": "1BSt6hCqnAMAMqhvMNerxOWe",
"amount": "10.00",
"currency": "usd",
"reason": "requested_by_customer",
"status": "succeeded",
"test": true
},
{
"refund_id": "1BiPhgNernAMAMqhvCTntF7aD",
"charge_id": "1BSt6hCqnAMAMqhvMGiBNerWe",
"amount": "10.00",
"currency": "usd",
"reason": "null",
"status": "succeeded",
"test": true
}
]

Obtener un reembolso​

Este endpoint devuelve solamente un objeto reembolso.

HTTP Request: GET https://api.4geeks.io/v1/refunds/<refund_id>/

Fields:

ParameterDescription
refund_idIdentificador del reembolso
.

Retorna

{
"refund_id": "1BiPhgCqnAMsdzqhvCTntF7aD",
"charge_id": "1BSt6hCqnAMAasd3vMGiBxOWe",
"amount": "10.00",
"currency": "usd",
"reason": "duplicate",
"status": "succeeded",
"test": true
}