Desembolso SWIFT

Una forma rápida de transferir fondos a una cuenta bancaria con SWIFT | Enterprise

Un desembolso puede enviar el dinero de Rapyd a un beneficiario. Use el método de desembolso Swift Transfer xx_swift_bank para transferir fondos a un beneficiario con una cuenta bancaria internacional en la red SWIFT.

Los casos de uso comunes pueden incluir:

Transfiere el desembolso a la cuenta bancaria de un empleado internacional.
Transfiere el desembolso a un distribuidor de otro país (B2B).

¿Qué es Regex?

Regex, es una expresión regular que define el formato cuando type es cadena, Regex puede gestionar y hacer coincidir los caracteres de las cadenas. Rapyd emplea una variante única de expresiones regulares. Tenga en cuenta las siguientes diferencias:

Un solo backslash se trata como si fuera un carácter ordinario.
Un backslash seguido de un carácter alfabético coincide con una cadena de dos caracteres.
Para hacer coincidir un carácter especial como \n, debe escribir \\n.

Flujo de trabajo de desembolso a cuenta bancaria

Usar el método de pago por transferencia bancaria (xx_swift_bank) y los campos obligatorios correspondientes que deben diligenciar los beneficiarios está descrito en Cómo funciona.

Nota

Un desembolso requiere un remitente y un beneficiario, tal y como se describe en Usar de nuevo un beneficiario o remitente.

Paso 1: Obtener información de desembolso

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

Paso 2: Procesar el pago

Usted solicita Crear desembolso y pasa los campos obligatorios.
Rapyd procesa el pago al banco y envía una respuesta.
El banco acredita la cuenta del beneficiario.
Rapyd envía una notificación cuando el desembolso se haya completado.

Cómo funcionan los desembolsos de SWIFT

Prerrequisitos

Para ejecutar los ejemplos de este caso de uso, debe crear el siguiente ID en su propio sandbox:

ewallet: ejecute Crear una billetera Rapyd para la billetera de la empresa. Use la ‘id’ que obtiene en la respuesta.

Encontrar tipos de métodos de desembolso

Para la página de desembolsos de su sitio web, necesita encontrar los tipos de métodos de desembolso que coincidan con sus criterios, como el país y la moneda de pago.

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

Descripción de los parámetros

Parámetro de consulta	Descripción
category	Introduzca bank como la categoría del método de desembolso.
beneficiary_country	Introduzca GB como código para el Reino Unido, el país del beneficiario.
payout_currency	Introduzca GBP como código de la libra esterlina británica, la moneda que recibe el beneficiario.

Solicitud para listar tipos de métodos de desembolso

Solicite una lista de todos los tipos de métodos de pago bancario disponibles para las transferencias en la red SWIFT al usar GBP .

Solicitud

// Request URL: GET https://sandboxapi.rapyd.net/v1/payout_methods?beneficiary_country=GB&payout_currency=GBP

// Message body absent

Respuesta de listar de tipos de métodos de desembolso

Veamos la respuesta.

Una respuesta real suele incluir muchos métodos de pago.

Respuesta

{
"payout_method_type": "xx_swift_bank",
"name": "Global SWIFT",
"is_cancelable": 0,
"is_expirable": 0,
"is_location_specific": 0,
"status": 1,
"image": "/checkout/xx_swift_bank.png",
"category": "bank",
"beneficiary_country": "GB",
"sender_country": "*",
"payout_currencies": [
    "GBP"
],
"sender_entity_types": [
    "company"
],
"beneficiary_entity_types": [
    "company",
    "individual"
],
"amount_range_per_currency": [
    {
        "maximum_amount": null,
        "minimum_amount": null,
        "payout_currency": "GBP"
    }
],
"minimum_expiration_seconds": null,
"maximum_expiration_seconds": null,
"sender_currencies": [
    "USD",
    "SGD",
    "SEK",
    "NOK",
    "ISK",
    "HKD",
    "GBP",
    "EUR",
    "DKK",
    "CHF",
    "AUD"
],
"estimated_time_of_arrival": "An estimated receipt time is not yet available for this payout method"
},

Monedas del remitente

El método de desembolso xx_swift_bank tiene una lista de las monedas de envío admitidas. Cuando el remitente procesa el desembolso de los fondos al beneficiario puede usar diferentes monedas admitidas.

El beneficiario puede entonces aceptar los fondos en la misma moneda o en una moneda diferente. Si un beneficiario acepta los fondos en una moneda diferente a la del remitente, FX (moneda extranjera, por sus siglas en inglés) convertirá los fondos a la moneda deseada.

Las monedas del remitente para el método de desembolso aparecen en la respuesta que aparece más adelante Listar tipos de métodos de desembolso.

Nota: Si el desembolso se crea con una moneda de remitente no admitida, no se realizará el pago.

Monedas del remitente compatibles con SWIFT

USD	GBP
SGD	EUR
SEK	DKK
NOK	CHF
ISK	NZD
HKD
AUD

Encontrar campos obligatorios para el tipo de método de desembolso

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

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

Descripción de los parámetros de ruta

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

Descripción de los parámetros de consulta

Parámetro de consulta	Descripción
sender_country	Introduzca FR como código para Francia, el país del remitente.
sender_currency	Introduzca EUR como código para euros, la moneda del remitente.
beneficiary_country	Introduzca GB como código para el Reino Unido, el país del beneficiario.
payout_currency	Introduzca GBP como código de la libra esterlina británica, la moneda que recibe el beneficiario.
sender_entity_type	Introduzca ‘company’ como tipo de entidad para el remitente.
beneficiary_entity_type	Introduzca ‘individual’ como tipo de entidad para el beneficiario.
payout_amount	Introduzca 3.000 como la cantidad recibida por el beneficiario.

Solicitud para obtener los campos obligatorios para el desembolso

Usted solicita el conjunto de campos obligatorios para el tipo de método de pago xx_swift_bank.

Solicitud

// Request URL: GET https://sandboxapi.rapyd.net/v1/payout_methods/xx_swift_bank/required_fields?sender_country=FR&sender_currency=EUR&beneficiary_country=GB&payout_currency=GBP&sender_entity_type=company&beneficiary_entity_type=individual&payout_amount=3000 

// Message body absent

Obtener respuesta de campos obligatorios de desembolso

Veamos la respuesta.

Respuesta

"status": {
       "error_code": "",
       "status": "SUCCESS",
       "message": "",
       "response_code": "",
       "operation_id": "6f8a3c1d-504f-4b9d-9b60-a83164c3053f"
   },
   "data": {
       "payout_method_type": "xx_swift_bank",
       "sender_currency": "EUR",
       "sender_country": "*",
       "sender_entity_type": "company",
       "beneficiary_country": "GB",
       "payout_currency": "GBP",
       "beneficiary_entity_type": "individual",
       "is_cancelable": 0,
       "is_location_specific": 0,
       "is_expirable": 0,
       "minimum_expiration_seconds": null,
       "maximum_expiration_seconds": null,
       "is_online": null,
       "image": "/checkout/xx_swift_bank.png",
       "status": 1,
       "beneficiary_required_fields": [
           {
               "name": "first_name",
               "regex": "^.{1,20}",
               "is_required": true,
               "type": "string",
               "description": "First name + Last name must not exceed 35 characters"
           },
           {
               "name": "last_name",
               "regex": "^.{1,15}",
               "is_required": true,
               "type": "string",
               "description": "First name + Last name must not exceed 35 characters"
           },
           {
               "name": "address",
               "regex": "^.{1,35}",
               "is_required": true,
               "type": "string",
               "description": "Beneficiary street name ; building number"
           },
           {
               "name": "city",
               "regex": "^.{1,25}",
               "is_required": true,
               "type": "string",
               "description": "The combined length of city+state+country+postcode must not exceed 32 characters"
           },
           {
               "name": "state",
               "regex": "^.{1,15}",
               "is_required": false,
               "type": "string",
               "description": "The combined length of city+state+country+postcode must not exceed 32 characters"
           },
           {
               "name": "country",
               "regex": "^[A-Z]{2}$",
               "is_required": true,
               "type": "string",
               "description": "The combined length of city+state+country+postcode must not exceed 32 characters"
           },
           {
               "name": "postcode",
               "regex": "^.{1,10}",
               "is_required": false,
               "type": "string",
               "description": "The combined length of city+state+country+postcode must not exceed 32 characters"
           },
           {
               "name": "account_number",
               "regex": "^.{1,34}$",
               "is_required": true,
               "type": "string"
           },
           {
               "name": "bic_swift",
               "regex": "^.{8,11}$",
               "is_required": true,
               "type": "string"
           }
       ],
       "sender_required_fields": [
           {
               "name": "company_name",
               "regex": "^.{1,35}",
               "is_required": true,
               "type": "string"
           },
           {
               "name": "address",
               "regex": "^.{1,35}",
               "is_required": true,
               "type": "string",
               "description": "Beneficiary street name ; building number"
           },
           {
               "name": "city",
               "regex": "^.{1,25}",
               "is_required": true,
               "type": "string",
               "description": "The combined length of city+state+country+postcode must not exceed 32 characters"
           },
           {
               "name": "state",
               "regex": "^.{1,15}",
               "is_required": false,
               "type": "string",
               "description": "The combined length of city+state+country+postcode must not exceed 32 characters"
           },
           {
               "name": "country",
               "regex": "^[A-Z]{2}$",
               "is_required": true,
               "type": "string",
               "description": "The combined length of city+state+country+postcode must not exceed 32 characters"
           },
           {
               "name": "postcode",
               "regex": "^.{1,10}",
               "is_required": false,
               "type": "string",
               "description": "The combined length of city+state+country+postcode must not exceed 32 characters"
           },
           {
               "name": "purpose_code",
               "regex": "investment_income|salary|insurance_payments|computer_services|educational_services|payment_of_goods|payment_of_services|Inward_remittance",
               "is_required": false,
               "type": "string",
               "allowed_values": [
                   "investment_income",
                   "salary",
                   "insurance_payments",
                   "computer_services",
                   "educational_services",
                   "payment_of_goods",
                   "payment_of_services",
                   "Inward_remittance"
               ],
               "description": "Required only for sending to - China, India, South Korea, Philippines, Malaysia"
           }
       ],
       "payout_options": [
           {
               "name": "beneficiary_country",
               "regex": "^[A-Z]{2}$",
               "is_required": true,
               "type": "string",
               "description": "Country where the beneficiary account is held"
           },
           {
               "name": "description",
               "regex": "^.{1,140}",
               "is_required": true,
               "type": "string",
               "description": "Payout purpose description"
           },
           {
               "name": "statement_descriptor",
               "regex": "^.{1,140}",
               "is_required": false,
               "type": "string",
               "description": "Information to be displayed in the beneficiary statement"
           }
       ],
       "minimum_amount": null,
       "maximum_amount": null,
       "batch_file_header": "payout_method_type,sender_currency,payout_currency,beneficiary.first_name,beneficiary.last_name,beneficiary.address,beneficiary.city,beneficiary.state,beneficiary.country,beneficiary.postcode,beneficiary.account_number,beneficiary.bic_swift,sender.company_name,sender.address,sender.city,sender.state,sender.country,sender.postcode,sender.purpose_code"
   }

La sección data de esta respuesta muestra los campos obligatorios para xx_swift_bank.

Cuando le pida a Rapyd que procese el desembolso, utilizará los campos obligatorios para los objetos de ‘beneficiary’ y ‘sender’:

Descripción de los campos

Beneficiary	Sender
first_name	company_name
last_name	address
address	city
city	country
country	purpose code (Consulte Código de propósito).
postcode
account_number
bic_swift

Sugerencia

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

Campos obligatorios por país

En las siguientes tablas se enumeran los requisitos de los campos obligatorios específicos de cada país.

Los campos utilizados en el métodos de desembolso xx_swift_bank están estandarizados. Sin embargo, cada país tiene diferentes requisitos para la información de los campos obligatorios de desembolso.

Limitaciones de longitud de campo

El beneficiario y el remitente tienen un límite de caracteres para los siguientes campos: ciudad, estado, país y código postal. La longitud combinada de los campos puede incluir un máximo de 32 caracteres para el remitente y un máximo de 32 caracteres para el beneficiario.

Caracteres compatibles

Los caracteres compatibles con los campos first_name , last_name, address, y description son:

a-z,
A-Z,
0-9
Caracteres especiales:/-? : ()., '+
Carácter de espacio

En las siguientes tablas se enumeran los requisitos de los campos obligatorios específicos de cada país.

Reino Unido (GB)

Objeto	Parámetro	Descripción
beneficiary_required_fields	first_name	Introduzca el nombre del beneficiario.
beneficiary_required_fields	last_name	Introduzca el apellido del beneficiario.
beneficiary_required_fields	address	Introduzca la dirección del beneficiario.
beneficiary_required_fields	city	Introduzca la ciudad del beneficiario.
beneficiary_required_fields	country	Introduzca el país del beneficiario.
beneficiary_required_fields	postcode	Introduzca el código postal del beneficiario.
beneficiary_required_fields	account_number	Use un IBAN para el campo del beneficiario `account_number`.
beneficiary_required_fields	bic_swift	Use el BIC 11 (incluidos los detalles de la sucursal) para el campo del beneficiario `bic_swift`.
sender_required_fields	company_name	Introduzca el nombre de la empresa del remitente.
sender_required_fields	dirección	Introduzca la dirección del remitente.
sender_required_fields	city	Introduzca la ciudad del remitente.
sender_required_fields	country	Introduzca el país del remitente.
sender_required_fields	purpose_code	Este campo no es obligatorio para este país.
payout_options	beneficiary_country	Introduzca el país del beneficiario.
payout_options	description	Introduzca el propósito del pago. Hasta 35 caracteres.
payout_options	statement_descriptor	Este campo no es obligatorio para este país.

Singapur (SG)

Objeto	Parámetro	Descripción
beneficiary_required_fields	first_name	Introduzca el nombre del beneficiario.
beneficiary_required_fields	last_name	Introduzca el apellido del beneficiario.
beneficiary_required_fields	address	Introduzca la dirección del beneficiario.
beneficiary_required_fields	city	Introduzca la ciudad del beneficiario.
beneficiary_required_fields	country	Introduzca el país del beneficiario.
beneficiary_required_fields	postcode	Introduzca el código postal del beneficiario.
beneficiary_required_fields	account_number	Introduzca el número de cuenta.
beneficiary_required_fields	bic_swift	Introduzca la información del BIC.
beneficiary_fields	bank_code	Código de identificación del banco local. Obligatorio para realizar pagos a: India, EE. UU., Reino Unido y Australia. Ejemplo: India (código IFSC): ICIC0001359 EE. UU. (número ABA): 123456789 Reino Unido (código de clasificación): 123456 Australia (código BSB): 082902
sender_required_fields	company_name	Introduzca el nombre de la empresa del remitente.
sender_required_fields	address	Introduzca la dirección del remitente.
sender_required_fields	city	Introduzca la ciudad del remitente.
sender_required_fields	country	Introduzca el país del remitente.
sender_required_fields	purpose_code	Este campo no es obligatorio para este país.
sender_fields	código_bancario	Código de identificación del banco local. Obligatorio para realizar pagos a: India, EE. UU., Reino Unido y Australia. Ejemplo: India (código IFSC): ICIC0001359 EE. UU. (número ABA): 123456789 Reino Unido (código de clasificación): 123456 Australia (código BSB): 082902
payout_options	beneficiary_country	Introduzca el país del beneficiario.
payout_options	description	Introduzca el propósito del pago. Hasta 35 caracteres.
payout_options	statement_descriptor	Este campo no es obligatorio para este país.

India (IN)

Objeto	Parámetro	Descripción
beneficiary_required_fields	first_name	Introduzca el nombre del beneficiario.
beneficiary_required_fields	last_name	Introduzca el apellido del beneficiario. Este campo puede dejarse vacío si el beneficiario solo tiene un nombre.
beneficiary_required_fields	address	Introduzca la dirección del beneficiario.
beneficiary_required_fields	city	Introduzca la ciudad del beneficiario.
beneficiary_required_fields	country	Introduzca el país del beneficiario.
beneficiary_required_fields	postcode	Introduzca el código postal del beneficiario.
beneficiary_required_fields	account_number	No puede contener guiones, espacios ni caracteres que no sean estándar.
beneficiary_required_fields	bic_swift	Introduzca la información del BIC.
sender_required_fields	company_name	Introduzca el nombre de la empresa del remitente.
sender_required_fields	address	Introduzca la dirección del remitente.
sender_required_fields	city	Introduzca la ciudad del remitente.
sender_required_fields	country	Introduzca el país del remitente.
sender_required_fields	purpose_code	Este campo es obligatorio para este país. Código de propósito.
payout_options	beneficiary_country	Introduzca el país del beneficiario.
payout_options	description	Introduzca el propósito del pago.
payout_options	statement_descriptor	El identificador de entidad jurídica (LEI, por sus siglas en inglés) debe estar presente para las transacciones superiores a 500.000 INR tanto para el beneficiario como para el remitente. Formato: ‘Rem LEI XXXXXXXXX Ben LEI XXXXXXXX’.

Tailandia (TH)

Nota

Transferencias iguales o superiores a THB 5 millones requieren documentación acreditativa que indique el propósito y el monto exacto de cada pago. La documentación justificativa incluye una copia de la factura o la solicitud de nómina, o una carta con membrete firmada en la que se describa el motivo de la transferencia.

Objeto	Parámetro	Descripción
beneficiary_required_fields	first_name	Introduzca el nombre del beneficiario.
beneficiary_required_fields	last_name	Introduzca el apellido del beneficiario.
beneficiary_required_fields	address	Introduzca la dirección del beneficiario.
beneficiary_required_fields	city	Introduzca la ciudad del beneficiario.
beneficiary_required_fields	country	Introduzca el país del beneficiario.
beneficiary_required_fields	postcode	Introduzca el código postal del beneficiario.
beneficiary_required_fields	account_number	Introduzca el número de cuenta.
beneficiary_required_fields	bic_swift	Introduzca la información del BIC.
sender_required_fields	company_name	Introduzca el nombre de la empresa del remitente.
sender_required_fields	address	Introduzca la dirección del remitente.
sender_required_fields	city	Introduzca la ciudad del remitente.
sender_required_fields	country	Introduzca el país del remitente.
sender_required_fields	purpose_code	Este campo no es obligatorio para este país.
payout_options	beneficiary_country	Introduzca el país del beneficiario.
payout_options	description	Introduzca el propósito del pago. Hasta 35 caracteres.
payout_options	statement_descriptor	Este campo no es obligatorio para este país.

Hong Kong (HK)

Objeto	Parámetro	Descripción
beneficiary_required_fields	first_name	Introduzca el nombre del beneficiario.
beneficiary_required_fields	last_name	Introduzca el apellido del beneficiario.
beneficiary_required_fields	address	Introduzca la dirección del beneficiario.
beneficiary_required_fields	city	Introduzca la ciudad del beneficiario.
beneficiary_required_fields	country	Introduzca el país del beneficiario.
beneficiary_required_fields	postcode	Introduzca el código postal del beneficiario.
beneficiary_required_fields	account_number	Introduzca el número de cuenta.
beneficiary_required_fields	bic_swift	Introduzca la información del BIC.
sender_required_fields	company_name	Introduzca el nombre de la empresa del remitente.
sender_required_fields	address	Introduzca la dirección del remitente.
sender_required_fields	city	Introduzca la ciudad del remitente.
sender_required_fields	country	Introduzca el país del remitente.
sender_required_fields	purpose_code	Este campo no es obligatorio para este país.
payout_options	beneficiary_country	Introduzca el país del beneficiario.
payout_options	description	Introduzca el propósito del pago. Hasta 35 caracteres.
payout_options	statement_descriptor	Este campo no es obligatorio para este país.

Malasia (MY)

Objeto	Parámetro	Descripción
beneficiary_required_fields	first_name	Introduzca el nombre del beneficiario.
beneficiary_required_fields	last_name	Introduzca el apellido del beneficiario.
beneficiary_required_fields	address	Introduzca la dirección del beneficiario.
beneficiary_required_fields	city	Introduzca la ciudad del beneficiario.
beneficiary_required_fields	country	Introduzca el país del beneficiario.
beneficiary_required_fields	postcode	Introduzca el código postal del beneficiario.
beneficiary_required_fields	account_number	Introduzca a el número de cuenta.
beneficiary_required_fields	bic_swift	Introduzca la información del BIC.
sender_required_fields	company_name	Introduzca el nombre de la empresa del remitente.
sender_required_fields	address	Introduzca la dirección del remitente.
sender_required_fields	city	Introduzca la ciudad del remitente.
sender_required_fields	country	Introduzca el país del remitente.
sender_required_fields	purpose_code	Este campo es obligatorio para este país. Código de propósito.
payout_options	beneficiary_country	Introduzca el país del beneficiario.
payout_options	description	Introduzca el propósito del pago. Hasta 15 caracteres.
payout_options	statement_descriptor	Este campo no es obligatorio para este país

Brasil (BR)

Objeto	Parámetro	Descripción
beneficiary_required_fields	first_name	Introduzca el nombre del beneficiario.
beneficiary_required_fields	last_name	Introduzca el apellido del beneficiario.
beneficiary_required_fields	address	Introduzca la dirección del beneficiario.
beneficiary_required_fields	city	Introduzca la ciudad del beneficiario.
beneficiary_required_fields	country	Introduzca el país del beneficiario.
beneficiary_required_fields	postcode	Introduzca el código postal del beneficiario.
beneficiary_required_fields	account_number	Use un IBAN para el campo del beneficiario `account_number` si está disponible.
beneficiary_required_fields	bic_swift	Introduzca la información del BIC.
sender_required_fields	company_name	Introduzca el nombre de la empresa del remitente.
sender_required_fields	address	Introduzca la dirección del remitente.
sender_required_fields	city	Introduzca la ciudad del remitente.
sender_required_fields	country	Introduzca el país del remitente.
sender_required_fields	purpose_code	Este campo no es obligatorio para este país.
payout_options	beneficiary_country	Introduzca el país del beneficiario.
payout_options	description	Introduzca el propósito del pago. Hasta 35 caracteres.
payout_options	statement_descriptor	Este campo no es obligatorio para este país.

Suiza (CH)

Objeto	Parámetro	Descripción
beneficiary_required_fields	first_name	Introduzca el nombre del beneficiario.
beneficiary_required_fields	last_name	Ingresa el apellido del beneficiario.
beneficiary_required_fields	address	Introduzca la dirección del beneficiario.
beneficiary_required_fields	city	Introduzca la ciudad del beneficiario.
beneficiary_required_fields	country	Introduzca el país del beneficiario.
beneficiary_required_fields	postcode	Introduzca el código postal del beneficiario.
beneficiary_required_fields	account_number	Use un IBAN para el campo del beneficiario `account_number` si está disponible.
beneficiary_required_fields	bic_swift	Introduzca la información del BIC.
sender_required_fields	company_name	Introduzca el nombre de la empresa del remitente.
sender_required_fields	address	Introduzca la dirección del remitente.
sender_required_fields	city	Introduzca la ciudad del remitente.
sender_required_fields	country	Introduzca el país del remitente.
sender_required_fields	purpose_code	Este campo no es obligatorio para este país.
payout_options	beneficiary_country	Introduzca el país del beneficiario.
payout_options	description	Introduzca el propósito del pago.
payout_options	statement_descriptor	Este campo no es obligatorio para este país.

Corea del Sur (KR)

Objeto	Parámetro	Descripción
beneficiary_required_fields	first_name	Introduzca el nombre del beneficiario.
beneficiary_required_fields	last_name	Introduzca el apellido del beneficiario.
beneficiary_required_fields	address	Introduzca la dirección del beneficiario.
beneficiary_required_fields	city	Introduzca la ciudad del beneficiario.
beneficiary_required_fields	country	Introduzca el país del beneficiario.
beneficiary_required_fields	postcode	Introduzca el código postal del beneficiario.
beneficiary_required_fields	account_number	Introduzca el número de cuenta.
beneficiary_required_fields	bic_swift	Introduzca la información del BIC.
sender_required_fields	company_name	Introduzca el nombre de la empresa del remitente.
sender_required_fields	address	Introduzca la dirección del remitente.
sender_required_fields	city	Introduzca la ciudad del remitente.
sender_required_fields	country	Introduzca el país del remitente.
sender_required_fields	purpose_code	Este campo es obligatorio para este país. Código de propósito.
payout_options	beneficiary_country	Introduzca el país del beneficiario.
payout_options	description	Introduzca el propósito del pago. Hasta 15 caracteres.
payout_options	statement_descriptor	Este campo no es obligatorio para este país.

Solicitar un desembolso

Su empresa es la remitente del desembolso y el empleado es el beneficiario que recibe el desembolso.

Cuando su gestor de nóminas solicita un pago de la billetera electrónica de la empresa a la cuenta bancaria de un empleado, usted le pide a Rapyd que procese el desembolso.

Para ello, utilizará Crear desembolso con los siguientes parámetros:

Descripción de los parámetros del cuerpo

Parámetro del cuerpo	Descripción
beneficiary	Introduzca un objeto ‘beneficiary’ que tenga los siguientes campos: `first_name`: Henry `last_name`: Tan `account_number`: 888449956988 `aba`: Introduzca el número de ruta ABA: 573675777
beneficiary_country	Introduzca GB como código para el Reino Unido, el país del beneficiario.
beneficiary_entity_type	Introduzca ‘individual’ como tipo de entidad para el beneficiario.
description	Introduzca ‘Pago de prueba: de banco a billetera ’ como descripción de la transacción de desembolso.
ewallet	Introduzca el ‘id’ de la billetera que recibió cuando creó la billetera de la empresa en su sandbox. Para fines de esta lección de casos de uso, estamos usando ewallet_27a63119c130f95a6ec59f86c93f28f8 el cual es el id de la billetera de la empresa que hemos creado en nuestro sandbox.
payout_amount	Introduzca 3.000 como la cantidad recibida por el beneficiario.
payout_currency	Introduzca GBP como código de la libra esterlina británica, la moneda que recibe el beneficiario.
payout_method_type	Introduzca xx_swift_bank como tipo de método de desembolso.
sender	Introduzca un objeto ‘sender’ que tenga los siguientes campos: `company_name`: introduzca el nombre de la empresa `purpose code`: introduzca el salario.
sender_currency	Introduzca EUR como código para euros, la moneda del remitente.
sender_entity_type	Introduzca ‘company’ como tipo de entidad para el remitente.
sender_country	Introduzca FR como código para Francia, el país del remitente.

Crear solicitud de desembolso

Le pide a Rapyd que procese el pago de 3.000 libras esterlinas a la cuenta bancaria del empleado en el Reino Unido.

Solicitud

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

// Message body: 
{
   "ewallet": "ewallet_27a63119c130f95a6ec59f86c93f28f8",
   "merchant_reference_id": "Test-Cash-8888",
   "payout_amount": 3000,
   "payout_method_type": "xx_swift_bank",
   "sender_currency": "EUR",
   "sender_country": "FR",
   "beneficiary_country": "GB",
   "payout_currency": "GBP",
   "sender_entity_type": "company",
   "beneficiary_entity_type": "individual",
   "beneficiary": {
       "payment_type": "regular",
       "address": "1 Main Street",
       "city": "Anytown",
       "country": "US",
       "first_name": "Henry",
       "last_name": "Tan",
       "state": "NY",
       "phone_number": "+145434653466",
       "postcode": "10101",
       "aba": "573675777",
       "account_number": "888********",
       "identification_type": "work_permit",
       "identification_value": "asdasd123123"
   },
    "sender": {
           "company_name" : "Test Sender 123",
           "city": "Anytown",
           "state": "NY",
           "phone_number": "+145434653466"
       },
   "description": "Test payout - bank to wallet",
   "statement_descriptor": "Test txn",
   "metadata": {
       "merchant_defined": true
   }
}

Crear respuesta de desembolso

Veamos la respuesta.

Respuesta

{
   "status": {
       "error_code": "",
       "status": "SUCCESS",
       "message": "",
       "response_code": "",
       "operation_id": "4a6e569e-0ed5-4a5c-a102-a47931cf248e"
   },
   "data": {
       "id": "payout_c87991aabb7266e4dcb8fc6f2a68505c",
       "payout_type": "bank",
       "payout_method_type": "xx_swift_bank",
       "amount": 3000,
       "payout_currency": "GBP",
       "sender_amount": 3527.09,
       "sender_currency": "EUR",
       "status": "Confirmation",
       "sender_country": "FR",
       "sender": {
           "country": "FR",
           "entity_type": "company",
           "name": "Test Sender 123",
           "city": "Anytown",
           "state": "NY",
           "phone_number": "+145434653466",
           "company_name": "Test Sender 123",
           "currency": "EUR"
       },
       "beneficiary_country": "GB",
       "beneficiary": {
           "last_name": "Tan",
           "first_name": "Henry",
           "country": "US",
           "entity_type": "individual",
           "address": "1 Main Street",
           "name": "Henry Tan",
           "postcode": "10101",
           "city": "Anytown",
           "state": "NY",
           "phone_number": "+145434653466",
           "account_number": "888********",
           "currency": "GBP",
           "identification_type": "work_permit",
           "identification_value": "asdasd123123",
           "aba": "573675777",
           "payment_type": "regular"
       },
       "fx_rate": 0.85055905,
       "instructions": {},
       "ewallets": [
           {
               "ewallet_id": "ewallet_27a63119c130f95a6ec59f86c93f28f8",
               "amount": 3527.09,
               "percent": 100
           }
       ],
       "metadata": {
           "merchant_defined": true
       },
       "description": "Test payout - bank to wallet",
       "created_at": 0,
       "payout_fees": null,
       "expiration": null,
       "merchant_reference_id": "Test-Cash-8888",
       "paid_at": null,
       "identifier_type": null,
       "identifier_value": null,
       "error": null,
       "paid_amount": 0,
       "statement_descriptor": "Test txn",
       "gc_error_code": "NOT_IMPLEMENTED"
   }
}

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

El id si el objeto de ‘payout’ es payout_c87991aabb7266e4dcb8fc6f2a68505c. Los webhooks relacionados con este desembolso hacen referencia a este.
El payout_type es un banco.
En sender: se listan los campos del objeto ‘sender’.
En beneficiary: se muestran los campos del objeto ‘beneficiary’.
El status es la confirmación. Esto significa que el objeto de ‘payout’ está esperando la confirmación de la tasa de FX.

Código de propósito

El código de propósito describe la naturaleza del pago o para qué sirve el pago. Estos son los valores posibles para el campo purpose_code:

Campo	Valor
purpose_code	investment_income
purpose_code	salary
purpose_code	insurance_payments
purpose_code	computer_services
purpose_code	educational_services
purpose_code	payment_of_goods
purpose_code	payment_of_services
purpose_code	Inward_remittance

Código de propósito: países obligatorios

Los siguientes países requieren un código de propósito para realizar un desembolso:

China
India
Corea del Sur
Filipinas
Malasia

Cierre de la transacción

Simulación de la finalización de un desembolso

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

Cuando se simula la finalización de un desembolso, Rapyd le envía un webhook. Configure su sistema para recibir webhooks con el procedimiento que se describe en Definición de un endpoint de webhook.

Tras simular que el banco del empleado ha aceptado la transferencia, Rapyd le envía Webhook: desembolso completado. El webhook confirma que el desembolso fue completado.

En esta sección:

Documentación

Desembolso SWIFT

¿Qué es Regex?

Flujo de trabajo de desembolso a cuenta bancaria

Nota

Paso 1: Obtener información de desembolso

Paso 2: Procesar el pago

Cómo funcionan los desembolsos de SWIFT

Prerrequisitos

Encontrar tipos de métodos de desembolso

Solicitud para listar tipos de métodos de desembolso

Respuesta de listar de tipos de métodos de desembolso

Monedas del remitente

Encontrar campos obligatorios para el tipo de método de desembolso

Solicitud para obtener los campos obligatorios para el desembolso

Obtener respuesta de campos obligatorios de desembolso

Sugerencia

Campos obligatorios por país

Limitaciones de longitud de campo

Nota

Solicitar un desembolso

Crear solicitud de desembolso

Crear respuesta de desembolso

Código de propósito

Código de propósito: países obligatorios

Cierre de la transacción

Resultados de la búsqueda