Pago de monedas estables

Crea un pago para un beneficiario usando criptomonedas.

Puedes crear un pago para un beneficiario con un monedero de criptomonedas. Puedes desembolsar el pago en monedas estables, un tipo de criptomoneda

Los casos de uso comunes pueden incluir:

Un pago a un empleado
Un pago a un proveedor
Un pago transfronterizo a un contratista

Flujo de trabajo de pago de Stablecoin

Paso 1: Obtener información de pago

Usted solicita Listar los métodos de pago por país para obtener los métodos de pago compatibles.
Rapyd devuelve la lista de tipos de pago admitidos.
Llama a Get Payout Method Required Fields para que se completen los campos obligatorios.
Rapyd devuelve la lista de campos obligatorios que deben pasarse para su procesamiento.

Paso 2: Procesar el pago

Tú llamas ¡Crea Payout y pase los campos obligatorios.
Rapyd procesa el pago.
Los fondos se acreditan a la billetera criptográfica beneficiaria.
Rapyd envía una notificación cuando el pago se ha completado.

Cómo funciona el pago de una moneda estable

Búsqueda de tipos de métodos de pago

Debes encontrar los tipos de métodos de pago que coincidan con tus criterios, como el país y la moneda de pago.

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

Para eso, utilizarás Enumere los tipos de métodos de pago con los siguientes parámetros:

Descripción de los parámetros de consulta

Parámetro de consulta	Descripción
categoría	Entrar monedero electrónico como la categoría del método de pago.
país_beneficiario	Entrar SER como código para Bélgica, el país del beneficiario.
divisa_de_pago	Entrar 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 pago

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

Para eso, utilizarás Obtenga los campos obligatorios de pago con los siguientes parámetros:

Nota

USDC y USDT son las divisas admitidas para este método de pago.

Descripción de los parámetros de ruta

Parámetro de ruta	Descripción
tipo_de_método de pago	Entrar xx_stablecoin_ewallet como tipo de método de pago.

Descripción de los parámetros de consulta

Parámetro de consulta	Descripción
país del remitente	Entrar AU como código de Australia, el país del remitente.
divisa del remitente	Entrar USD como el código del dólar estadounidense, la moneda del remitente.
país_beneficiario	Entrar SER como código para Bélgica, el país del beneficiario.
divisa_de_pago	Entrar USDC o USDT como código para la moneda estable, la moneda recibida por el beneficiario.
tipo_de_entidad_remitente	Entrar empresa como el tipo de entidad para el remitente.
tipo_de_entidad_beneficiaria	Entrar empresa como el tipo de entidad para el beneficiario.
importa_desembolso	Entrar 15 como la cantidad recibida por el beneficiario.

Campos obligatorios para obtener el pago 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 Validación de los detalles del beneficiario.

Solicitar un pago

Utilice Crear un pago con los siguientes parámetros:

Descripción de los parámetros corporales

Parámetro corporal	Descripción
cantidad	Entrar 15 como la cantidad recibida por el beneficiario.
tipo_de_método de pago	Entrar xx_stablecoin_ewallet como tipo de método de pago.
divisa del remitente	Entrar USD como el código del dólar estadounidense, la moneda del remitente.
país del remitente	Entrar AU como código de Australia, el país del remitente.
país_beneficiario	Entrar SER como código para Bélgica, el país del beneficiario. Este campo no es obligatorio.
divisa_de_pago	Entrar USDC o USDT como código para la moneda estable, la moneda recibida por el beneficiario.
tipo_de_entidad_remitente	Introduzca «empresa» como tipo de entidad para el remitente.
tipo_de_entidad_beneficiaria	Introduzca «empresa» como tipo de entidad para el beneficiario.
beneficiario	Introduzca un objeto «beneficiario» que tenga los siguientes campos: nombre_empresa - empresa valor_identificación - empresa nombre_de_pila - individuo apellido_nombre - individuo fecha_de_nacimiento - individual dirección_monedero_criptográfico protocolo_monedero criptográfico - Valores posibles: Etereum (ERC20) Cadena inteligente BNB (BEP20) Polígono (POLÍGONO) dirección - persona física o empresa ciudad - individuo o empresa país - persona física o empresa
remitente	Introduzca un objeto «remitente» que tenga los siguientes campos: nombre_empresa - empresa
descripción	Introduzca «pago de salario» como descripción de la transacción de pago.

Crear solicitud de pago

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, el datos la sección de esta respuesta muestra:

El Id si el objeto de «pago» es payout_97247402357168cb96af1f637c50ef16. Los webhooks relacionados con este pago hacen referencia a este ID
El payout_type es billetera electrónica.
Bajo remitente:
- El Id es sender_ad97cb5c91de8bf5ddab4673904f8a6b.
- Se muestran los campos del objeto «remitente».
Bajo beneficiario:
- El Id es beneficiary_269a4dcdde6ccc408dfc8af3379b5096.
- Se muestran los campos del objeto «beneficiario».
Nota: El valor del crypto_payout_hash este campo se puede usar para buscar la transacción en la red correspondiente y proporcionar un comprobante de pago.

Cierre de la transacción

Simulación de la finalización de un pago

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ás el ID de pago y el importe de pago que generaste en tu

Cuando se simula la finalización de un pago, Rapyd envía un webhook. Configura tu sistema para recibir webhooks Definición de un endpoint de webhook

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

En esta sección:

Documentación