Desembolso de monedas estables

Cree un desembolso para un beneficiario usando criptomonedas.

Puede crear un desembolso para un beneficiario con una billetera de criptomonedas. Puede desembolsar el pago en monedas estables, un tipo de criptomoneda.

Los casos de uso comunes pueden incluir:

Un desembolso a un empleado
Un desembolso a un distribuidor
Un desembolso transfronterizo a un contratista

Flujo de trabajo del desembolso de monedas estables

Paso 1: Obtener información de desembolso

Usted solicita Listar los métodos de pago por país para obtener los métodos de desembolso compatibles.
Rapyd le devuelve la lista de los métodos de pago admitidos.
Usted solicita Obtener los campos requeridos del método de desembolso para que se completen los campos obligatorios.
Rapyd le devuelve la lista de campos obligatorios que deben pasar para su procesamiento.

Paso 2: Procesar el desembolso

Usted solicita Crear desembolso y pasa los campos obligatorios.
Rapyd procesa el pago.
Se acreditan los fondos a la billetera criptográfica beneficiaria.
Cuando el pago se haya completado, Rapyd envía una notificación.

Cómo funciona el desembolso de una moneda estable

Búsqueda de tipos de métodos de desembolso

Debe encontrar los tipos de métodos de desembolso que coinciden con sus criterios, como el país y la moneda de desembolso.

En este ejemplo, encontrará tipos de métodos de pago que admiten transferencias en monedas estables a un beneficiario en Bélgica.

Para ello, utilizará Listar tipos de métodos de desembolso con los siguientes parámetros:

Descripción de los parámetros de consulta

Parámetro de consulta	Descripción
category	Introduzca ewallet como categoría del método de desembolso.
beneficiary_country	Introduzca BE como código para Bélgica, el país del beneficiario.
payout_currency	Introduzca USDC o USDT como código para la moneda estable, la moneda recibida por el beneficiario.

Lista de tipos de métodos de pago proporciona ejemplos de la solicitud y la respuesta.

Búsqueda de campos obligatorios para el tipo de método de desembolso

Debe encontrar los campos obligatorios para el tipo de método de desembolso xx_stablecoin_ewallet.

Para eso, utilizará Obtener los campos obligatorios de desembolso con los siguientes parámetros:

Nota

USDC y USDT son las monedas admitidas para este método de desembolso.

Descripción de los parámetros de ruta

Parámetro de ruta	Descripción
payout_method_type	Introduzca xx_stablecoin_ewallet como tipo de método de desembolso.

Descripción de los parámetros de consulta

Parámetro de consulta	Descripción
sender_country	Introduzca AU como código de Australia, el país del remitente.
sender_currency	Introduzca USD como código del dólar estadounidense, la moneda del remitente.
beneficiary_country	Introduzca BE como código para Bélgica, el país del beneficiario.
payout_currency	Introduzca USDC o USDT como código para la moneda estable, la moneda recibida por el beneficiario.
sender_entity_type	Introduzca empresa como tipo de entidad para el remitente.
beneficiary_entity_type	Introduzca empresa como el tipo de entidad para el beneficiario.
payout_amount	Introduzca 15 como la cantidad recibida por el beneficiario.

Campos obligatorios para obtener el desembolso muestra un ejemplo de la solicitud y la respuesta.

Sugerencia

Utilice Validar beneficiario para comprobar los campos del beneficiario antes de solicitar el pago. Consulte Validar detalles del beneficiario.

Solicitar un desembolso

Utilice Crear un desembolso con los siguientes parámetros:

Descripción de los parámetros del cuerpo

Parámetro del cuerpo	Descripción
amount	Introduzca 15 como la cantidad recibida por el beneficiario.
payout_method_type	Introduzca xx_stablecoin_ewallet como tipo de método de desembolso.
sender_currency	Introduzca USD como código del dólar estadounidense, la moneda del remitente.
sender_country	Introduzca AU como código de Australia, el país del remitente.
beneficiary_country	Introduzca BE como código para Bélgica, el país del beneficiario. Este campo no es obligatorio.
payout_currency	Introduzca USDC o USDT como código para la moneda estable, la moneda recibida por el beneficiario.
sender_entity_type	Introduzca ‘company’ como tipo de entidad para el remitente.
beneficiary_entity_type	Introduzca ‘company’ como tipo de entidad para el beneficiario.
beneficiary	Introduzca un objeto ‘beneficiary’ que tenga los siguientes campos: company_name: empresa identification_value: empresa first_name: individuo last_name: individuo date_of_birth: individuo crypto_wallet_address crypto_wallet_protocol: Valores posibles: Etereum (ERC20) BNB Smart Chain (BEP20) Polygon (POLYGON) address: empresa o individuo city: individuo o empresa country: empresa o individuo
sender	Introduzca un objeto ‘sender’ que tenga los siguientes campos: company_name: empresa
description	Introduzca ‘desembolso de salario’ como descripción de la transacción de desembolso.

Crear solicitud de desembolso

Solicitud

// Request URL: POST https://sandboxapi.rapyd.net/v1/payouts

// Message body: 

{
        "amount": 15,
        "beneficiary": {
          "company_name": "Bene Company",
          "crypto_wallet_address": "0x02ae6765C6991813a3EAa86fe63ebBCA1c9EC156",
          "crypto_wallet_protocol": "ERC20",
          "address": "a2123",
          "city": "test",
          "country": "DE",
          "identification_value": "31425791789"
        },
        "beneficiary_country": "BE",
        "beneficiary_entity_type": "company",
        "payout_currency": "USDC",
        "payout_method_type": "xx_stablecoin_ewallet",
        "sender": {
          "company_name": "Sen"
        },
        "confirm_automatically": true,
        "sender_country": "AU",
        "sender_currency": "USD",
        "sender_entity_type": "company",
        "description": "new description"      
}

Crear respuesta de pago

Respuesta

{
    "status": {
        "error_code": "",
        "status": "SUCCESS",
        "message": "",
        "response_code": "",
        "operation_id": "2b9f713f-0710-48d5-9cc8-559cd8980a00"
    },
    "data": {
        "id": "payout_97247402357168cb96af1f637c50ef16",
        "payout_type": "ewallet",
        "payout_method_type": "xx_stablecoin_ewallet",
        "amount": 15,
        "payout_currency": "USDC",
        "sender_amount": 16.28,
        "sender_currency": "USD",
        "status": "Created",
        "sender_country": "AU",
        "sender": {
            "id": "sender_ad97cb5c91de8bf5ddab4673904f8a6b",
            "country": "AU",
            "entity_type": "company",
            "name": "Sen",
            "company_name": "Sen",
            "currency": "USD"
        },
        "beneficiary_country": "BE",
        "beneficiary": {
            "id": "beneficiary_269a4dcdde6ccc408dfc8af3379b5096",
            "country": "DE",
            "entity_type": "company",
            "address": "a2123",
            "name": "Bene Company",
            "city": "test",
            "company_name": "Bene Company",
            "currency": "USDC",
            "identification_value": "***********",
            "crypto_wallet_address": "0x02ae6765C6991813a3EAa86fe63ebBCA1c9EC156",
            "crypto_wallet_protocol": "ERC20"
        },
        "fx_rate": 0.9215,
        "instructions": [
            {
                "name": "instructions",
                "steps": [
                    {
                        "step1": "The funds will be transferred to the Crypto wallet address of the beneficiary"
                    }
                ]
            }
        ],
        "ewallets": [
            {
                "ewallet_id": "ewallet_c4bb3c5ae31339a86490096b73075860",
                "amount": 16.28,
                "percent": 100
            }
        ],
        "metadata": {},
        "description": "new description",
        "created_at": 1743602136,
        "payout_fees": null,
        "expiration": null,
        "paid_at": null,
        "identifier_type": null,
        "identifier_value": null,
        "error": null,
        "paid_amount": 0,
        "statement_descriptor": null,
        "gc_error_code": null,
        "batch_file": null,
        "estimated_time_of_arrival": "The beneficiary will receive the funds within few minutes.",
        "crypto_payout_hash": null
    }
}

Además de los valores de los parámetros que ha introducido en la solicitud, la sección data de esta respuesta muestra:

El id si el objeto de ‘payout’ es payout_97247402357168cb96af1f637c50ef16. Los webhooks relacionados con este pago hacen referencia a este ID.
El payout_type es ewallet.
En sender:
- El id es sender_ad97cb5c91de8bf5ddab4673904f8a6b.
- Se muestran los campos del objeto ‘sender’.
En beneficiary:
- El id es beneficiary_269a4dcdde6ccc408dfc8af3379b5096.
- Se muestran los campos del objeto ‘beneficiary’.
Nota: El valor para el campo crypto_payout_hash puede usarse para buscar la transacción en la red correspondiente y proporcionar un comprobante de pago.

Cierre de la transacción

Simular la finalización de un desembolso

El sandbox no simula directamente la acción del beneficiario que recibe los fondos de pago. Puede simular esta acción con Desembolso completo. Para ello, necesitará el ID de pago y el importe de pago que generó en su sandbox.

Cuando se simula la finalización de un desembolso, Rapyd envía un webhook. Configure su sistema para recibir webhooks Definición de un endpoint de webhook

Tras simular que el desembolso ha sido aceptado, Rapyd le envía Webhook: desembolso completado. El webhook confirma que se completó el desembolso.

En esta sección:

Documentación