Pedidos de la Organization
Revisa los pedidos de todos los Merchants de la Organization desde el Dashboard — lístalos, fíltralos y abre uno para ver el detalle completo.
Estos endpoints consolidan los pedidos de todos los Merchants de la Organization en un solo lugar: filtra por Merchant, estado o período, y abre un pedido para ver sus artículos y las transacciones que lo pagaron.
Es el equivalente a nivel de toda la Organization de la pantalla de pedidos del Merchant — los mismos registros de pedidos, agregados entre Merchants para informes y soporte.
Estos endpoints impulsan la interfaz del Tokeflow Dashboard a nivel de la Organization. Están autenticados por sesión (JWT bearer) — el token proviene de iniciar sesión en el Dashboard, no de una clave de API sk_/pk_. Las solicitudes también incluyen el header x-organization-id, y el usuario que inició sesión debe ser miembro de esa Organization.
Endpoints
GET/api/v1/org/orders
Auth: Dashboard session (JWT bearer). Se requiere membresía de la Organization.
Lista los pedidos de la Organization.
Parámetros de consulta
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
page | number | No | Número de página (indexado desde 1). Predeterminado 1, mín. 1. |
limit | number | No | Número de elementos por página. Predeterminado 20, mín. 1, máx. 100. |
status | array | No | Lista de estados de pedido separados por comas |
order_type | string | No | Filtra por tipo de pedido |
recurrence | string | No | Filtra por recurrencia |
currency | string | No | Filtra por moneda (ISO 4217) |
search | string | No | Busca por ID de pedido, nombre del cliente, correo electrónico o ID externo del pedido |
start_date | string | No | Fecha de inicio (ISO 8601) |
end_date | string | No | Fecha de fin (ISO 8601) |
mode | string | No | live o test. Solo los pedidos cuyo pago más reciente que llegó a un proveedor se ejecutó en un conector en vivo (o de prueba). Un pedido sin un pago así no coincide con ninguno de los dos. |
subscription_id | string | No | Filtra por ID de suscripción |
Ejemplo de solicitud
curl -G https://api.tokeflow.com/api/v1/org/orders \
-H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9…" \
-H "x-organization-id: org_4b21e7c3" \
--data-urlencode "page=1" \
--data-urlencode "limit=20" \
--data-urlencode "status=['active']" \
--data-urlencode "order_type=api"GET/api/v1/org/orders/:id
Auth: Dashboard session (JWT bearer). Se requiere membresía de la Organization.
Obtiene un pedido por ID.
El detalle del pedido incluye las transacciones que lo pagaron y cada uno de sus intentos. Cada pedido y cada transacción llevan un mode (live, test, o null cuando ningún pago llegó a un proveedor), y cada intento lleva is_test_mode. Un intento fallido también muestra decline_reason — el motivo del fallo según Tokeflow, el mismo valor sea cual sea el proveedor que respondió — junto a psp_decline_code y psp_error_type, el código y la clase de error propios del proveedor tal como los informó.
Parámetros de ruta
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
id | string | Sí | — |
Ejemplo de solicitud
curl https://api.tokeflow.com/api/v1/org/orders/obj_1a2b3c4d \
-H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9…" \
-H "x-organization-id: org_4b21e7c3"GET/api/v1/org/orders/:id/attempts/:attemptId/raw-response
Auth: Dashboard session (JWT bearer). Se requiere membresía de la Organization.
Obtiene la respuesta sin procesar del PSP para un intento.
Parámetros de ruta
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
id | string | Sí | — |
attemptId | string | Sí | — |
Ejemplo de solicitud
curl https://api.tokeflow.com/api/v1/org/orders/obj_1a2b3c4d/attempts/123/raw-response \
-H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9…" \
-H "x-organization-id: org_4b21e7c3"POST/api/v1/org/orders/:id/refund
Auth: Dashboard session (JWT bearer). Se requiere membresía de la Organization.
Reembolsa un pedido.
Parámetros de ruta
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
id | string | Sí | — |
Campos de la solicitud
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
amount | number | No | Importe a reembolsar en unidades menores (reembolso parcial). Omítelo para un reembolso total. |
reason | string | No | Motivo del reembolso. Uno de duplicate, fraudulent, requested_by_customer. |
Ejemplo de solicitud
curl -X POST https://api.tokeflow.com/api/v1/org/orders/obj_1a2b3c4d/refund \
-H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9…" \
-H "x-organization-id: org_4b21e7c3" \
-H "Content-Type: application/json" \
-d '{
"amount": 15000,
"reason": "requested_by_customer"
}'GET/api/v1/org/orders/:id/refunds
Auth: Dashboard session (JWT bearer). Se requiere membresía de la Organization.
Lista los reembolsos de un pedido.
Parámetros de ruta
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
id | string | Sí | — |
Parámetros de consulta
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
page | number | No | Número de página (indexado desde 1). Predeterminado 1, mín. 1. |
limit | number | No | Número de elementos por página. Predeterminado 20, mín. 1, máx. 100. |
Ejemplo de solicitud
curl -G https://api.tokeflow.com/api/v1/org/orders/obj_1a2b3c4d/refunds \
-H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9…" \
-H "x-organization-id: org_4b21e7c3" \
--data-urlencode "page=1" \
--data-urlencode "limit=20"Errores
Los errores usan el envoltorio estándar. Los casos más comunes aquí:
| HTTP | Significado |
|---|---|
400 | Parámetros inválidos o un estado que no permite esta operación. |
401 | Token de sesión del Dashboard ausente, expirado o inválido. |
403 | Autenticado, pero el usuario que inició sesión no tiene acceso a esta entidad. |
404 | El registro no existe o no es visible para esta entidad. |