Pago SWIFT

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

Un Payout puede enviar dinero de Rapyd a un beneficiario. Usa el método de pago 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 pago a la cuenta bancaria de un empleado internacional.
Transferencia bancaria a un proveedor de otro país (B2B).

¿Qué es Regex?

Regex, es una expresión regular que define el formato cuando escriba 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

Se considera que una barra invertida simple coincide con una barra invertida como un carácter normal.
Una barra invertida seguida de un carácter alfabético coincide con una cadena de dos caracteres.
Para hacer coincidir un carácter especial como \n, debes escribir \\n.

Flujo de trabajo de pago a cuenta bancaria

Uso del método de pago por transferencia bancaria (xx_swift_bank) y los campos obligatorios correspondientes que deben rellenar los beneficiarios se describen en Cómo funciona.

Nota

Un pago requiere un remitente y un beneficiario, tal y como se describe en Beneficiario o remitente reutilizables.

Paso 1: Obtener información de pago

Solicitas enumerar 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

Llamas a Create Payout y pasas 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 pago se ha completado.

Cómo funciona SWIFT Payouts

Prerrequisitos

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

ewallet - Ejecutar Creando una billetera rápida para la cartera de la empresa. Usa la «identificación» que obtienes en la respuesta.

Búsqueda de tipos de métodos de pago

Para la página de pago de tu sitio web, necesitas encontrar los tipos de métodos de pago que coincidan con tus criterios, como el país y la moneda de pago.

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

Descripción de los parámetros

Parámetro de consulta	Descripción
categoría	Ingresa banco como la categoría del método de pago.
país_beneficiario	Entrar GB como código para el Reino Unido, el país del beneficiario.
divisa_de_pago	Entrar GBP como código de la libra esterlina británica, la moneda que recibe el beneficiario.

Solicitud de tipos de métodos de pago de listas

Solicita una lista de todos los tipos de métodos de pago bancarios disponibles para las transferencias en la red SWIFT mediante GBP .

Solicitud

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

// Message body absent

Lista de tipos de métodos de pago y respuesta

Echemos un vistazo a 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"
},

Divisas del remitente

El xx_swift_bank método de pago tiene una lista de las divisas de envío admitidas. Cuando el remitente desembolsa los fondos al beneficiario, puede usar diferentes divisas 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) convertirá los fondos a la moneda deseada.

Las divisas del remitente del método de pago aparecen en la respuesta Lista de tipos de métodos de pago que aparece más arriba.

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

Divisas de remitente compatibles SWIFT

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

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

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

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

Descripción de los parámetros de ruta

Parámetro de ruta	Descripción
tipo_de_método de pago	Entrar xx_swift_bank 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 FR como código para Francia, el país del remitente.
divisa del remitente	Entrar EUR como código para euros, la moneda del remitente.
país_beneficiario	Entrar GB como código para el Reino Unido, el país del beneficiario.
divisa_de_pago	Entrar GBP como código de la libra esterlina británica, la moneda que recibe el beneficiario.
tipo_de_entidad_remitente	Introduzca «empresa» como tipo de entidad para el remitente.
tipo_de_entidad_beneficiaria	Introduzca «individuo» como tipo de entidad para el beneficiario.
importa_desembolso	Ingresa 3000 como la cantidad recibida por el beneficiario.

Solicitud de campos obligatorios para obtener el pago

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

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 pago

Echemos un vistazo a 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"
   }

El datos la sección de esta respuesta muestra los campos obligatorios para xx_swift_bank.

Cuando pidas a Rapyd que procese el pago, utilizarás los campos obligatorios para las objeciones de «beneficiario» y «remitente»:

Descripción de los campos

Beneficiario	Remitente
nombre_de_pila	nombre_empresa
apellido_nombre	dirección
dirección	ciudad
ciudad	país
país	código de propósito (consulte Código de propósito .)
código postal
número_cuenta
bic_swift

Sugerencia

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

Campos obligatorios por país

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

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

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.

Personajes compatibles

Los caracteres compatibles con nombre_de_pila , apellido, dirección, y descripción los campos son:

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

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

Reino Unido (GB)

Objeto	Parámetro	Descripción
campos_requeridos_beneficiarios	nombre_de_pila	Introduzca el nombre del beneficiario
campos_requeridos_beneficiarios	apellido_nombre	Ingresa el apellido del beneficiario
campos_requeridos_beneficiarios	dirección	Introduzca la dirección del beneficiario
campos_requeridos_beneficiarios	ciudad	Introduzca la ciudad del beneficiario
campos_requeridos_beneficiarios	país	Introduzca el país del beneficiario
campos_requeridos_beneficiarios	código postal	Introduzca el código postal del beneficiario
campos_requeridos_beneficiarios	número_cuenta	Usa un IBAN para el beneficiario `account_number` campo
campos_requeridos_beneficiarios	bic_swift	Use el BIC 11 (incluidos los detalles de la sucursal) para el beneficiario `bic_swift` campo
campos_requeridos_remitentes	nombre_empresa	Introduzca el nombre de la empresa del remitente
campos_requeridos_remitentes	dirección	Introduzca la dirección del remitente
campos_requeridos_remitentes	ciudad	Introduzca la ciudad del remitente
campos_requeridos_remitentes	país	Introduzca el país del remitente
campos_requeridos_remitentes	código_propósito	Este campo no es obligatorio para este país
opciones_de_pago	país_beneficiario	Introduzca el país del beneficiario
opciones_de_pago	descripción	Introduzca el propósito del pago. Hasta 35 caracteres.
opciones_de_pago	descriptor_de_declaración	Este campo no es obligatorio para este país

Singapur (SG)

Objeto	Parámetro	Descripción
campos_requeridos_beneficiarios	nombre_de_pila	Introduzca el nombre del beneficiario
campos_requeridos_beneficiarios	apellido_nombre	Ingresa el apellido del beneficiario
campos_requeridos_beneficiarios	dirección	Introduzca la dirección del beneficiario
campos_requeridos_beneficiarios	ciudad	Introduzca la ciudad del beneficiario
campos_requeridos_beneficiarios	país	Introduzca el país del beneficiario
campos_requeridos_beneficiarios	código postal	Introduzca el código postal del beneficiario
campos_requeridos_beneficiarios	número_cuenta	Ingresa el número de cuenta
campos_requeridos_beneficiarios	bic_swift	Introduzca la información del BIC
campos_beneficiarios	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
campos_requeridos_remitentes	nombre_empresa	Introduzca el nombre de la empresa del remitente
campos_requeridos_remitentes	dirección	Introduzca la dirección del remitente
campos_requeridos_remitentes	ciudad	Introduzca la ciudad del remitente
campos_requeridos_remitentes	país	Introduzca el país del remitente
campos_requeridos_remitentes	código_propósito	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
opciones_de_pago	país_beneficiario	Introduzca el país del beneficiario
opciones_de_pago	descripción	Introduzca el propósito del pago. Hasta 35 caracteres.
opciones_de_pago	descriptor_de_declaración	Este campo no es obligatorio para este país

India (IN)

Objeto	Parámetro	Descripción
campos_requeridos_beneficiarios	nombre_de_pila	Introduzca el nombre del beneficiario
campos_requeridos_beneficiarios	apellido_nombre	Ingresa el apellido del beneficiario. Este campo puede dejarse vacío si el beneficiario solo tiene un nombre.
campos_requeridos_beneficiarios	dirección	Introduzca la dirección del beneficiario
campos_requeridos_beneficiarios	ciudad	Introduzca la ciudad del beneficiario
campos_requeridos_beneficiarios	país	Introduzca el país del beneficiario
campos_requeridos_beneficiarios	código postal	Introduzca el código postal del beneficiario
campos_requeridos_beneficiarios	número_cuenta	No puede contener guiones, espacios ni caracteres no estándar.
campos_requeridos_beneficiarios	bic_swift	Introduzca la información del BIC.
campos_requeridos_remitentes	nombre_empresa	Introduzca el nombre de la empresa del remitente
campos_requeridos_remitentes	dirección	Introduzca la dirección del remitente
campos_requeridos_remitentes	ciudad	Introduzca la ciudad del remitente
campos_requeridos_remitentes	país	Introduzca el país del remitente
campos_requeridos_remitentes	código_propósito	Este campo es obligatorio para este país. Código de propósito
opciones_de_pago	país_beneficiario	Introduzca el país del beneficiario
opciones_de_pago	descripción	Introduzca el propósito del pago.
opciones_de_pago	descriptor_de_declaración	El identificador de entidad jurídica (LEI) 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 requieren 5 millones de documentación acreditativa que indique el propósito y el importe 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
campos_requeridos_beneficiarios	nombre_de_pila	Introduzca el nombre del beneficiario
campos_requeridos_beneficiarios	apellido_nombre	Ingresa el apellido del beneficiario
campos_requeridos_beneficiarios	dirección	Introduzca la dirección del beneficiario
campos_requeridos_beneficiarios	ciudad	Introduzca la ciudad del beneficiario
campos_requeridos_beneficiarios	país	Introduzca el país del beneficiario
campos_requeridos_beneficiarios	código postal	Introduzca el código postal del beneficiario
campos_requeridos_beneficiarios	número_cuenta	Ingresa el número de cuenta
campos_requeridos_beneficiarios	bic_swift	Introduzca la información del BIC
campos_requeridos_remitentes	nombre_empresa	Introduzca el nombre de la empresa del remitente
campos_requeridos_remitentes	dirección	Introduzca la dirección del remitente
campos_requeridos_remitentes	ciudad	Introduzca la ciudad del remitente
campos_requeridos_remitentes	país	Introduzca el país del remitente
campos_requeridos_remitentes	código_propósito	Este campo no es obligatorio para este país
opciones_de_pago	país_beneficiario	Introduzca el país del beneficiario
opciones_de_pago	descripción	Introduzca el propósito del pago. Hasta 35 caracteres.
opciones_de_pago	descriptor_de_declaración	Este campo no es obligatorio para este país

Hong Kong (HK)

Objeto	Parámetro	Descripción
campos_requeridos_beneficiarios	nombre_de_pila	Introduzca el nombre del beneficiario
campos_requeridos_beneficiarios	apellido_nombre	Ingresa el apellido del beneficiario
campos_requeridos_beneficiarios	dirección	Introduzca la dirección del beneficiario
campos_requeridos_beneficiarios	ciudad	Introduzca la ciudad del beneficiario
campos_requeridos_beneficiarios	país	Introduzca el país del beneficiario
campos_requeridos_beneficiarios	código postal	Introduzca el código postal del beneficiario
campos_requeridos_beneficiarios	número_cuenta	Ingresa el número de cuenta
campos_requeridos_beneficiarios	bic_swift	Introduzca la información del BIC.
campos_requeridos_remitentes	nombre_empresa	Introduzca el nombre de la empresa del remitente
campos_requeridos_remitentes	dirección	Introduzca la dirección del remitente
campos_requeridos_remitentes	ciudad	Introduzca la ciudad del remitente
campos_requeridos_remitentes	país	Introduzca el país del remitente
campos_requeridos_remitentes	código_propósito	Este campo no es obligatorio para este país
opciones_de_pago	país_beneficiario	Introduzca el país del beneficiario
opciones_de_pago	descripción	Introduzca el propósito del pago. Hasta 35 caracteres.
opciones_de_pago	descriptor_de_declaración	Este campo no es obligatorio para este país

Malasia (MY)

Objeto	Parámetro	Descripción
campos_requeridos_beneficiarios	nombre_de_pila	Introduzca el nombre del beneficiario
campos_requeridos_beneficiarios	apellido_nombre	Ingresa el apellido del beneficiario
campos_requeridos_beneficiarios	dirección	Introduzca la dirección del beneficiario
campos_requeridos_beneficiarios	ciudad	Introduzca la ciudad del beneficiario
campos_requeridos_beneficiarios	país	Introduzca el país del beneficiario
campos_requeridos_beneficiarios	código postal	Introduzca el código postal del beneficiario
campos_requeridos_beneficiarios	número_cuenta	Ingresa el número de cuenta
campos_requeridos_beneficiarios	bic_swift	Introduzca la información del BIC
campos_requeridos_remitentes	nombre_empresa	Introduzca el nombre de la empresa del remitente
campos_requeridos_remitentes	dirección	Introduzca la dirección del remitente
campos_requeridos_remitentes	ciudad	Introduzca la ciudad del remitente
campos_requeridos_remitentes	país	Introduzca el país del remitente
campos_requeridos_remitentes	código_propósito	Este campo es obligatorio para este país. Código de propósito
opciones_de_pago	país_beneficiario	Introduzca el país del beneficiario
opciones_de_pago	descripción	Introduzca el propósito del pago. Hasta 15 caracteres.
opciones_de_pago	descriptor_de_declaración	Este campo no es obligatorio para este país

Brasil (BR)

Objeto	Parámetro	Descripción
campos_requeridos_beneficiarios	nombre_de_pila	Introduzca el nombre del beneficiario
campos_requeridos_beneficiarios	apellido_nombre	Ingresa el apellido del beneficiario
campos_requeridos_beneficiarios	dirección	Introduzca la dirección del beneficiario
campos_requeridos_beneficiarios	ciudad	Introduzca la ciudad del beneficiario
campos_requeridos_beneficiarios	país	Introduzca el país del beneficiario
campos_requeridos_beneficiarios	código postal	Introduzca el código postal del beneficiario
campos_requeridos_beneficiarios	número_cuenta	Usa un IBAN para el beneficiario `account_number` campo si está disponible
campos_requeridos_beneficiarios	bic_swift	Introduzca la información del BIC
campos_requeridos_remitentes	nombre_empresa	Introduzca el nombre de la empresa del remitente
campos_requeridos_remitentes	dirección	Introduzca la dirección del remitente
campos_requeridos_remitentes	ciudad	Introduzca la ciudad del remitente
campos_requeridos_remitentes	país	Introduzca el país del remitente
campos_requeridos_remitentes	código_propósito	Este campo no es obligatorio para este país
opciones_de_pago	país_beneficiario	Introduzca el país del beneficiario
opciones_de_pago	descripción	Introduzca el propósito del pago. Hasta 35 caracteres.
opciones_de_pago	descriptor_de_declaración	Este campo no es obligatorio para este país

Suiza (CH)

Objeto	Parámetro	Descripción
campos_requeridos_beneficiarios	nombre_de_pila	Introduzca el nombre del beneficiario
campos_requeridos_beneficiarios	apellido_nombre	Ingresa el apellido del beneficiario
campos_requeridos_beneficiarios	dirección	Introduzca la dirección del beneficiario
campos_requeridos_beneficiarios	ciudad	Introduzca la ciudad del beneficiario
campos_requeridos_beneficiarios	país	Introduzca el país del beneficiario
campos_requeridos_beneficiarios	código postal	Introduzca el código postal del beneficiario
campos_requeridos_beneficiarios	número_cuenta	Usa un IBAN para el beneficiario `account_number` campo si está disponible
campos_requeridos_beneficiarios	bic_swift	Introduzca la información del BIC
campos_requeridos_remitentes	nombre_empresa	Introduzca el nombre de la empresa del remitente
campos_requeridos_remitentes	dirección	Introduzca la dirección del remitente
campos_requeridos_remitentes	ciudad	Introduzca la ciudad del remitente
campos_requeridos_remitentes	país	Introduzca el país del remitente
campos_requeridos_remitentes	código_propósito	Este campo no es obligatorio para este país
opciones_de_pago	país_beneficiario	Introduzca el país del beneficiario
opciones_de_pago	descripción	Introduzca el propósito del pago
opciones_de_pago	descriptor_de_declaración	Este campo no es obligatorio para este país

Corea del Sur (KR)

Objeto	Parámetro	Descripción
campos_requeridos_beneficiarios	nombre_de_pila	Introduzca el nombre del beneficiario
campos_requeridos_beneficiarios	apellido_nombre	Ingresa el apellido del beneficiario
campos_requeridos_beneficiarios	dirección	Introduzca la dirección del beneficiario
campos_requeridos_beneficiarios	ciudad	Introduzca la ciudad del beneficiario
campos_requeridos_beneficiarios	país	Introduzca el país del beneficiario
campos_requeridos_beneficiarios	código postal	Introduzca el código postal del beneficiario
campos_requeridos_beneficiarios	número_cuenta	Ingresa el número de cuenta
campos_requeridos_beneficiarios	bic_swift	Introduzca la información del BIC
campos_requeridos_remitentes	nombre_empresa	Introduzca el nombre de la empresa del remitente
campos_requeridos_remitentes	dirección	Introduzca la dirección del remitente
campos_requeridos_remitentes	ciudad	Introduzca la ciudad del remitente
campos_requeridos_remitentes	país	Introduzca el país del remitente
campos_requeridos_remitentes	código_propósito	Este campo es obligatorio para este país. Código de propósito
opciones_de_pago	país_beneficiario	Introduzca el país del beneficiario
opciones_de_pago	descripción	Introduzca el propósito del pago. Hasta 15 caracteres.
opciones_de_pago	descriptor_de_declaración	Este campo no es obligatorio para este país

Solicitar un pago

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

Cuando tu gestor de nóminas solicita un pago del monedero electrónico de la empresa a la cuenta bancaria de un empleado, le pides a Rapyd que procese el pago.

Para eso, utilizarás Crea Payout con los siguientes parámetros:

Descripción de los parámetros corporales

Parámetro corporal	Descripción
beneficiario	Introduzca un objeto «beneficiario» que tenga los siguientes campos: `nombre_de_pila` - Henry `apellido_nombre` - Bronceado `número_cuenta` - 888449956988 `aba` - Introduzca el número de ruta ABA: 573675777
país_beneficiario	Entrar GB como código para el Reino Unido, el país del beneficiario.
tipo_de_entidad_beneficiaria	Introduzca «individuo» como tipo de entidad para el beneficiario.
descripción	Introduce «Pago de prueba: de banco a monedero» como descripción de la transacción de pago.
monedero electrónico	Introduce el «identificador» de la cartera que recibiste cuando creaste la cartera de la empresa en tu entorno de pruebas. Para los fines de esta lección de casos de uso, estamos usando ewallet_27a63119c130f95a6ec59f86c93f28f8, que es el identificador de cartera de la empresa que hemos creado en nuestra zona de pruebas.
importa_desembolso	Ingresa 3000 como la cantidad recibida por el beneficiario.
divisa_de_pago	Entrar GBP como código de la libra esterlina británica, la moneda que recibe el beneficiario.
tipo_de_método de pago	Entrar xx_swift_bank como tipo de método de pago.
remitente	Introduzca un objeto «remitente» que tenga los siguientes campos:`nombre_empresa` - Introduzca el nombre de la empresa`código de propósito` - Introduzca el salario
divisa del remitente	Entrar EUR como código para euros, la moneda del remitente.
tipo_de_entidad_remitente	Introduzca «empresa» como tipo de entidad para el remitente.
país del remitente	Entrar FR como código para Francia, el país del remitente.

Crear solicitud de pago

Le pides a Rapyd que procese el pago de 3000 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 pago

Echemos un vistazo a 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 ingresaste en la solicitud, la sección de datos de esta respuesta muestra:

El Id si el objeto de «pago» es payout_c87991aabb7266e4dcb8fc6f2a68505c. Los webhooks relacionados con este pago hacen referencia a este ID
El payout_type es un banco.
Bajo remitente: Se muestran los campos del objeto «remitente».
Bajo beneficiario: Se muestran los campos del objeto «beneficiario».
El estado es confirmación. Esto significa que el objeto de «pago» está esperando la confirmación del tipo de cambio

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 purpose_code campo:

Campo	Valor
código_propósito	ingresos_de_inversión
código_propósito	salario
código_propósito	pagos_de_seguros
código_propósito	servicios_informáticos
código_propósito	servicios_educativos
código_propósito	pago_de_bienes
código_propósito	pago_de_servicios
código_propósito	Remesas entrantes

Código de propósito Países obligatorios

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

China
India
Corea del Sur
Filipinas
Malasia

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 el banco del empleado ha aceptado la transferencia, Rapyd te envía Webhook: pago completado. El webhook confirma que se completó el pago

En esta sección:

Documentación

Pago SWIFT

¿Qué es Regex?

Flujo de trabajo de pago a cuenta bancaria

Nota

Paso 1: Obtener información de pago

Paso 2: Procesar el pago

Cómo funciona SWIFT Payouts

Prerrequisitos

Búsqueda de tipos de métodos de pago

Solicitud de tipos de métodos de pago de listas

Lista de tipos de métodos de pago y respuesta

Divisas del remitente

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

Solicitud de campos obligatorios para obtener el pago

Obtener respuesta de campos obligatorios de pago

Sugerencia

Campos obligatorios por país

Limitaciones de longitud de campo

Nota

Solicitar un pago

Crear solicitud de pago

Crear respuesta de pago

Código de propósito

Código de propósito Países obligatorios

Cierre de la transacción

Resultados de la búsqueda