Devolución de pedidos
Sólo se aceptan solicitudes de devolución para pedidos confirmados.
Para realizar una devolución se hará de una manera u otra dependiendo del tipo de operación.
Financiación online
Devoluciones Financiación online.
Un pedido acepta varias devoluciones parciales siempre que el sumatorio del importe de las mismas no supere el total del pedido original. Si se devuelve el importe total, el pedido será cancelado.
Cada operación de devolución parcial afecta al importe de las futuras cuotas de un crédito. El importe de la devolución se verá reflejado en las liquidaciones del comercio y puede implicar una operación de devolución del importe al comprador.
01 - Comprobar cantidad restante
- http
- shell
- python
- php
- C#
GET /orders/:orderId/refund HTTP/1.1
Accept: application/vnd.aplazame.v1+json
Authorization: Bearer api_private_key
Host: api.aplazame.com
$ curl "https://api.aplazame.com/orders/:orderId/refund" \
-H "Accept: application/vnd.aplazame.v1+json" \
-H "Authorization: Bearer api_private_key"
import aplazame_sdk
client = aplazame_sdk.Client('api_private_key')
response = client.refund_check(':orderId')
<?php
use Aplazame\Api\Client as AplazameClient;
$aplazameClient = new AplazameClient("https://api.aplazame.com", AplazameClient::ENVIRONMENT_PRODUCTION, " api_private_key");
$result = $aplazameClient->get("/orders/{$orderId}/refund");
using Aplazame.Api;
Client client = new Client("https://api.aplazame.com", Client.EnvironmentProduction, " api_private_key");
dynamic result = client.Get($"/orders/{orderId}/refund");
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
| :orderId | string | Sí | ID del pedido. |
Respuesta
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
X-Aplazame-Media-Type: aplazame.v1
{
"remaining_amount": 70070
}
02 - Solicitar devolución
- http
- shell
- python
- php
- C#
POST /orders/:orderId/refund HTTP/1.1
Accept: application/vnd.aplazame.v1+json
Authorization: Bearer api_private_key
Host: api.aplazame.com
{
"amount": 10050
}
$ curl "https://api.aplazame.com/orders/:orderId/refund" \
-H "Accept: application/vnd.aplazame.v1+json" \
-H "Authorization: Bearer api_private_key" \
-X POST \
-d "amount=10050"
import aplazame_sdk
client = aplazame_sdk.Client('api_private_key')
response = client.refund(':orderId', 10050)
<?php
use Aplazame\Api\Client as AplazameClient;
$aplazameClient = new AplazameClient("https://api.aplazame.com", AplazameClient::ENVIRONMENT_PRODUCTION, " api_private_key");
$result = $aplazameClient->post("/orders/{$orderId}/refund", ["amount" => Aplazame\Serializer\Decimal::fromFloat(100.50)->value]);
using Aplazame.Api;
Client client = new Client("https://api.aplazame.com", Client.EnvironmentProduction, " api_private_key");
dynamic result = client.Post($"/orders/{orderId}/refund", new {amount = Aplazame.Serializer.DecimalType.FromDouble(100.50)});
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
| :orderId | string | Sí | ID del pedido. |
| amount | decimal | Sí | Importe a devolver. |
Respuesta
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
X-Aplazame-Media-Type: aplazame.v1
{
"remaining_amount": 60020
}
| Parámetro | Tipo | Descripción |
|---|---|---|
| remaining_amount | decimal | Cantidad restante del pedido. |
Pago en 15 días
La devolución para la modalidad de pago en 15 días se realiza a nivel de captura dentro de un pedido.
Una captura de un pedido acepta varias devoluciones parciales siempre que el sumatorio del importe de las mismas no supere el total de la captura original.
{
"id": "db654bf752a84b7eaf6fcb7ab5801f60",
"amount": 10050,
"pending_amount": 0,
"accrual_date": "2019-06-21",
"credit_to_customer": 0,
"completed": false,
"completed_but_defaults": false,
"created": "2019-06-21T16:52:07.733892+02:00"
}
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
| id | string | Sí | id de la devolución. |
| amount | decimal | Sí | Importe de la devolución. |
| pending_amount | decimal | Sí | Cantidad restante de la captura. |
| accrual_date | string | Sí | Fecha efectiva. |
| credit_to_customer | decimal | Sí | Importe devuelto al cliente. |
| completed | boolean | Sí | Pedido completado. |
| completed_but_defaults | boolean | Sí | Pedido completado peor con deudas. |
| created | string | Sí | Fecha de la devolución. |
01 - Comprobar cantidad restante
- http
- shell
- python
- php
- C#
GET /orders/:orderId/captures/:captureId/refunds HTTP/1.1
Accept: application/vnd.aplazame.v1+json
Authorization: Bearer api_private_key
Host: api.aplazame.com
$ curl "https://api.aplazame.com/orders/:orderId/captures/:captureId/refunds" \
-H "Accept: application/vnd.aplazame.v1+json" \
-H "Authorization: Bearer api_private_key"
import aplazame_sdk
client = aplazame_sdk.Client('api_private_key')
response = client.get_capture_refund(':orderId', ':captureId')
<?php
use Aplazame\Api\Client as AplazameClient;
$aplazameClient = new AplazameClient("https://api.aplazame.com", AplazameClient::ENVIRONMENT_PRODUCTION, " api_private_key");
$result = $aplazameClient->get("/orders/{$orderId}/captures/{$captureId}/refunds");
using Aplazame.Api;
Client client = new Client("https://api.aplazame.com", Client.EnvironmentProduction, " api_private_key");
dynamic result = client.Get($"/orders/{orderId}/captures/{captureId}/refunds");
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
| :orderId | string | Sí | ID del pedido. |
| :captureId | string | Sí | ID de la captura. |
Respuesta
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
X-Aplazame-Media-Type: aplazame.v1
{
"amount": 70070,
"id": "cf04aa87a6364f14b164e48a84e99936",
"created": "2019-06-21T16:51:19.494155+02:00",
"refunds": [],
"refunded_amount": 0,
"remaining_amount": 70070
}
| Parámetro | Tipo | Descripción |
|---|---|---|
| amount | decimal | Importe de la captura. |
| id | string | id de la captura. |
| created | string | Fecha de la captura. |
| refunds | object | Devoluciones realizadas a la captura. |
| refunded_amount | decimal | Cantidad devuelta de la captura. |
| remaining_amount | decimal | Cantidad restante de la captura. |
02 - Solicitar devolución
- http
- shell
- python
- php
- C#
POST /orders/:orderId/captures/:captureId/refunds HTTP/1.1
Accept: application/vnd.aplazame.v1+json
Authorization: Bearer api_private_key
Host: api.aplazame.com
{
"amount": 10050
}
$ curl "https://api.aplazame.com/orders/:orderId/captures/:captureId/refunds" \
-H "Accept: application/vnd.aplazame.v1+json" \
-H "Authorization: Bearer api_private_key" \
-X POST \
-d "amount=10050"
import aplazame_sdk
client = aplazame_sdk.Client('api_private_key')
response = client.capture_refund(':orderId', ':captureId', 10050)
<?php
use Aplazame\Api\Client as AplazameClient;
$aplazameClient = new AplazameClient("https://api.aplazame.com", AplazameClient::ENVIRONMENT_PRODUCTION, " api_private_key");
$result = $aplazameClient->post("/orders/{$orderId}/captures/{$captureId}/refunds", ["amount" => Aplazame\Serializer\Decimal::fromFloat(100.50)->value]);
using Aplazame.Api;
Client client = new Client("https://api.aplazame.com", Client.EnvironmentProduction, " api_private_key");
dynamic result = client.Post($"/orders/{orderId}/captures/{captureId}/refunds", new {amount = Aplazame.Serializer.DecimalType.FromDouble(100.50)});
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
| :orderId | string | Sí | ID del pedido. |
| :captureId | string | Sí | ID de la captura. |
| amount | decimal | Sí | Importe a devolver. |
Respuesta
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
X-Aplazame-Media-Type: aplazame.v1
{
"amount": 70070,
"id": "cf04aa87a6364f14b164e48a84e99936",
"created": "2019-06-21T16:51:19.494155+02:00",
"refunds": [
{
"id": "db654bf752a84b7eaf6fcb7ab5801f60",
"amount": 10050,
"pending_amount": 60020,
"accrual_date": "2019-06-21",
"credit_to_customer": 0,
"completed": false,
"completed_but_defaults": false,
"created": "2019-06-21T16:52:07.733892+02:00"
}
],
"refunded_amount": 10050,
"remaining_amount": 60020
}
| Parámetro | Tipo | Descripción |
|---|---|---|
| amount | decimal | Importe de la captura. |
| id | string | id de la captura. |
| created | string | Fecha de la captura. |
| refunds | object | Devoluciones realizadas a la captura. |
| refunded_amount | decimal | Cantidad devuelta de la captura. |
| remaining_amount | decimal | Cantidad restante de la captura. |