GET /movement/{id}
Devuelve el detalle completo de una transacción a partir de su ID único.
Útil cuando necesitas verificar el estado actual de una transacción específica sin descargar todo el historial, o cuando recibes un ID por otro canal (notificación, sistema de órdenes) y quieres confirmar sus detalles en Yappy.
Request
GET {{BASE_URL}}/movement/{id}
api-key: {tu-api-key}
secret-key: {tu-clave-secreta}
authorization: {token-jwt}
Ejemplo:
GET {{BASE_URL}}/movement/ASOWE-45283003
No requiere body ni parámetros adicionales — el ID va en el path.
El id de una transacción aparece en el campo id de cada elemento devuelto por POST /movement/history. Tiene el formato XXXXX-XXXXXXXX (5 letras mayúsculas, guión, 8 dígitos), por ejemplo FCIZK-90454086.
Response — 200 OK
La estructura es idéntica a un elemento del array transactions del historial:
{
"status": {
"code": "YP-0000",
"description": "Se ha realizado la ejecución del servicio correctamente"
},
"body": {
"id": "ASOWE-45283003",
"number": "MOCK-jamihs05",
"type": "TXN-ECOM",
"status": "REVERSED",
"description": "Por pedido: xJoK02cTOEUI",
"role": "CREDIT",
"category": "INTRABANK",
"fee": {
"currency": "USD",
"amount": 0.16
},
"charge": {
"currency": "USD",
"tax": 0,
"tip": 0,
"amount": 10.11,
"partial_amount": 10.11
},
"debitor": {
"alias": "+50768994657",
"complete_name": "Kallie Keeling",
"alias_type": "P",
"bank_name": "Banco General"
},
"creditor": {
"alias": "Sitio web",
"complete_name": "Mi Comercio S.A."
}
}
}
Para el diccionario completo de campos, consulta la referencia del historial.
Errores posibles
| Código | Significado |
|---|---|
YP-0001 | No se encontró ninguna transacción con ese ID. |
YP-0008 | Faltan headers obligatorios. |
YP-0002 | Error genérico de plataforma. |