Sobre callbacks y notificaciones vía API

Modificado el Lun., 27 Abr. a las 6:01 P. M.

¿La integración API admite notificaciones de estado? ¿Se puede especificar la URL de notificación?

Sí. Nuestros servidores intentarán llamar a un endpoint de tu lado para notificarte los cambios de estado en las transacciones. La URL de notificación se puede especificar a través de la API.

¿La API proporciona callbacks para compras (pay-ins) y retiros (pay-outs)?

Sí. Consulta la documentación de la API de compras y pagos.

¿Pueden proporcionar un ejemplo de una respuesta de notificación?

Las APIs de compras (pay-ins) y pagos (pay-outs) intentarán notificarte los cambios de estado enviando un POST similar a los siguientes:

Para pay-outs:

{
    "id": "f8dd11dd-12fe-42f7-8e5c-9035714dd43d",
    "code": null,
    "amount": "200.00",
    "status": "completed",
    "cancel_uri": null,
    "created_at": "2021-01-30T07:47:01.055Z",
    "partner_id": "4c41f826-115f-40d6-b34c-2a5885e51d27",
    "updated_at": "2021-01-30T07:47:02.061Z",
    "description": "Some description provided by the partner",
    "failure_uri": "https://example.com/123/failure",
    "airtm_user_id": "119500e5-094f-4020-beb4-69f5b6f32ee7",
    "failure_reason": null,
    "operation_type": "payout",
    "airtm_user_email": "useremail@hotmail.com",
    "confirmation_uri": "https://example.com/123/confirmed",
    "airtm_operation_id": "cfcd89bd-f3e7-4525-af61-83d906e5117c"
}

Para pay-ins:

{
    "id": "f85e1a28-0ee4-468f-896d-cbb2caf536de",
    "code": "123456",
    "amount": "1.00",
    "status": "confirmed",
    "cancel_uri": "http://myserver.mydomain/cancel",
    "created_at": "2022-08-15T23:42:16.933Z",
    "partner_id": "afe23416-1d7f-4c54-803f-7e87cdd193ba",
    "updated_at": "2022-08-15T23:42:34.016Z",
    "description": "Test purchase",
    "failure_uri": null,
    "callback_uri": "http://myserver.mydomain/callback",
    "airtm_user_id": "6bd1e5b1-7d12-4112-aa1c-3e67454b56f6",
    "failure_reason": null,
    "operation_type": "purchase",
    "airtm_user_email": "some@email.com",
    "confirmation_uri": "http://myserver.mydomain/confirmed",
    "airtm_operation_id": "cd529399-1df5-42e2-b2e8-64962eb72562",
    "airtm_operation_hash": "1DF5PR42E2CPB2E8"
}