Consulta de devoluciones
En esta sección se podrá comprender cómo consultar las devoluciones de una orden y conocer los diferentes estados en que puede estar una devolución.
Consultar devoluciones de una orden
Podemos consultar las devoluciones de una orden de la siguiente manera.
curl --location --request GET 'https://api.conekta.io/orders/ord_XXXXXXXXXXX' \
--header 'Content-Type: application/json' \
--header 'Accept: application/vnd.conekta-v2.1.0+json' \
--header 'Authorization: Bearer YOUR_PRIVATE_API_KEY'
{
"livemode": true,
"amount": 50000,
"currency": "MXN",
"payment_status": "paid",
"amount_refunded": 0,
"customer_info": {
"email": "[email protected]",
"phone": "5555555555",
"name": "User",
"object": "customer_info"
},
"object": "order",
"id": "ord_2tV3dPk9GgaNB9xT8",
"metadata": {},
"is_refundable": true,
"created_at": 1678220457,
"updated_at": 1678220631,
"line_items": {
"object": "list",
"has_more": false,
"data": [
{
"name": "Box of Cohiba S1s",
"unit_price": 50000,
"quantity": 1,
"object": "line_item",
"id": "line_item_2tV3dPk9GgaNB9xT6",
"parent_id": "ord_2tV3dPk9GgaNB9xT8",
"metadata": {},
"antifraud_info": {}
}
]
},
"charges": {
"object": "list",
"has_more": false,
"data": [
{
"id": "64079ca9d6014f0001bff56c",
"livemode": true,
"created_at": 1678220457,
"currency": "MXN",
"device_fingerprint": "bQ1LRyesr68DTLXqED6PM6R43zzHxu5A",
"payment_method": {
"service_name": "OxxoPay",
"barcode_url": "https://pt-common-s3-stg.s3.amazonaws.com/b82841dcf44ae5065f8cd0085e61269317a6bf02.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ASIA3UN6375MM6EA7VM7%2F20230307%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20230307T202057Z&X-Amz-Expires=604800&X-Amz-Security-Token=IQoJb3JpZ2luX2VjEH0aCXVzLWVhc3QtMSJIMEYCIQCv3Fsz63Um%2B0Vn38NocHbSYpEzsX9VNykWzHoK4F1dBwIhAJLVN3Er61cXAnKlq0Y0jfjEw0t3Sr6OjZFt47EeSnJsKocECDUQAhoMNzk5ODAxMDgxNjg4Igwt0ywP6dVtDG3JpD4q5ANPD4vHJt6zBAwgEgHcccJ3rGJtsLWjGQlRjwO0Ay25REL9VY6LGBvOrHYej1ff2yhER2U80uL8IQ4ye6fo%2FG4v2APZDqT%2FEMkztQQvPJGvH%2FG7LG0vGCZ7B%2B9%2Brg8t%2FUsd2nEA4TDW53bkWj8n7szwx3qu0pguVVkT4gUb6NDpsP81LUVQ2JxRTdk%2BRxkXOZ45A77Xlz2RmZYC9BZD2KCAUomVdZT0h4AaDLkbBMvxpn0JmGBeo6BwzKq4xiAn5qX0Ook%2Bda3ZqIgpcXEZAQABuqjgxtiyORCGEm9DyoNIaMu%2FoQ0ypFpAMCbuGRT%2BcLlsomJK4NuZzB35mr405bAxMO4wsLSa8OnWYMOhesw0q2ImStr8CYG8hI9L%2BwlT5D4UhRIAERCwBz1SentQKIGMjinSidYSRgUj8LT9vIM6txYTkvWXjG1zMoPoIB0KGkGjPeLIQRVG7pRwoEUyzvseeSva%2BKfyzNT1dW33c1aZcfNU%2FPDI%2FwRDPWu6Zl7pOAd1GmIVngJVLpxQ%2BW88EnAw974GmMQ4Su7QUX%2Bre4r3BQWqDfMf1Rm1HM2bWZbtoEd6IDTV%2B7GLfz0s4cuodL4Z3j25%2BMAgROTw1JOnCiR1GBpD6wDqxfq7TLMCS%2BG%2FxpD91nS1MNW1nqAGOqQBWzQ49dZhFndmOPBHzy202Tg6GOVBGG%2B%2BCte7JS4SGWRJyJwY88rlFHLWa475emCKovJrFB9afj9HM77Z1XSi4sUgxLsqTzWCYy22Muvc3ezezssNVKGXWWSKvysBlyw90zx3C6m6v%2Fge%2FLi54d63yFIviHbJnGJYc5AmHZdO8%2Fqx9Goci4qiBRyCEbdCKKFyDenaPjs3hzxrD%2F04%2FD%2Fs%2FL0Qbjc%3D&X-Amz-SignedHeaders=host&X-Amz-Signature=aebed155ad9c2abbc44546fc92363d77f8dfb8f79e893db8ced76ae89bf6c2eb",
"store": "10MON50EDI",
"auth_code": 991466079,
"object": "cash_payment",
"type": "oxxo",
"expires_at": 1680825600,
"store_name": "OXXO",
"reference": "93000262280777"
},
"object": "charge",
"description": "Payment from order",
"status": "paid",
"amount": 50000,
"paid_at": 1678220631,
"fee": 1160,
"customer_id": "cus_2tV3frEGmADZsH31P",
"order_id": "ord_2tV3dPk9GgaNB9xT8",
"refunds": {
"object": "list",
"has_more": false,
"data": [
{
"object": "cash_refund",
"amount": -50000,
"id": "64079d6bd6014f0001bff582",
"created_at": 1678220651,
"reference": "1021466226004832",
"payout_id": "74c81ffd-07f3-47c6-9b0a-ff7a03XXXXX",
"status": "pending",
"expires_at": 1678393450
}
]
}
}
]
}
}
La respuesta contiene la orden con sus cargos, dentro de los cargos encontramos la llave refunds.
Estados de una devolución
Estado | Descripción |
---|---|
pending | Se ha generado una nueva devolución pero aún no se ha retirado. |
canceled | Se muestra cuando una devolución ha sido cancelado por el comercio. |
expired | Se muestra cuando una devolución fue expirado y esta no fue cobrada por el usuario. |
withdrawn | Se muestra cuando una devolución ha sido retirada exitosamente. |
Updated 4 months ago