Cancelación y consulta de retiros

Cancelación de la referencia

La cancelación de la referencia la puedes realizar en cualquier momento.

❗️

IMPORTANTE:

Una vez realizada la solicitud el cliente no podrá realizar ningún retiro con la referencia entregada.

-H "Accept: application/vnd.conekta-v2.1.0+json" \
-H "Content-type: application/json" \
-u key_YOUR_PRIVATE_API_KEY: \
-X PUT https://api.conekta.io/payout_orders/4468474a-48ed-4732-9f8a-666238eaa0ac/cancel
{
    "id": "4468474a-48ed-4732-9f8a-666238eaa0ac",
    "amount": 3000,
    "currency": "MXN",
    "allowed_payout_methods": ["cash"],
    "reason": "Referencia de devolución",
    "object": "payout_order",
    "expires_at": 1624032864,
    "metadata": {
        "custom_client_id": "12345"
    },
    "status": "cancelled",
    "payouts": [{
        "id": "payout_2pwMgf9irhCLzMfCZ",
        "amount": 3000,
        "currency": "MXN",
        "payout_method": {
            "object": "payout_method",
            "type": "cash"
        },
        "object": "payout",
        "expires_at": 1624032864
    }]
}

Parámetros de la cancelación

ParámetroDescripciónTipo
idID de transacciónGuid

Consulta de una orden de pago

Puedes consultar en cualquier momento el estatus de la transacción, esto se realiza a través de la siguiente consulta:

-H "Accept: application/vnd.conekta-v2.1.0+json" \
-H "Content-type: application/json" \
-u key_YOUR_PRIVATE_API_KEY: \
-X GET https://api.conekta.io/payout_orders/4468474a-48ed-4732-9f8a-666238eaa0ac
{
    "id": "",
    "amount": 3000,
    "currency": "MXN",
    "allowed_payout_methods": ["cash"],
    "reason": "Referencia de devolución",
    "object": "payout_order",
    "expires_at": 1624032864,
    "metadata": {
        "custom_client_id": "12345"
    },
    "status": "cancelled",
    "payouts": [{
        "id": "payout_2pwMgf9irhCLzMfCZ",
        "amount": 3000,
        "currency": "MXN",
        "payout_method": {
            "object": "payout_method",
            "type": "cash"
        },
        "object": "payout",
        "expires_at": 1624032864
    }]
}

*Parámetros de la consulta

ParámetroDescripciónTipo
idID de transacciónGuid

Estatus de transacción

Los siguientes estatus son los disponibles para una transacción:

NombreDescripción
openEstado inicial, cambia inmediatamente a pending apenas se crea la transacción.
pendingTransacción creada y pendiente de cobrar.
cancelledTransacción cancelada por el comercio.
expiredTransacción expirada.
pending_confirmationTransacción en proceso de confirmar retiro.
withdrawnTransacción exitosa.
reversedTransacción reversada, durante la espera de confirmación de retiro (3 minutos) se recibió una solicitud de reversa.