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.

¿Dónde consigo el ID?

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ódigoSignificado
YP-0001No se encontró ninguna transacción con ese ID.
YP-0008Faltan headers obligatorios.
YP-0002Error genérico de plataforma.
¿Te fue útil esta página?