Create Bank Transfer

Crea una transferencia bancaria SEPA desde la cuenta bancaria del usuario a un beneficiario externo.

Parámetros requeridos en el body (JSON):

name: Nombre del beneficiario

surname: Apellidos del beneficiario

concept: Concepto o descripción de la transferencia

amount: Importe de la transferencia (número positivo)

iban: IBAN del beneficiario (formato: ES1234567890123456789012)

sort_code (opcional) Si la transferencia tiene el currency GBP

external_id: ID externo único para asociar la transferencia

Autenticación requerida: Sí

Respuesta exitosa incluye:

Información completa de la transferencia creada

external_id asociado para rastreo

Errores posibles:

authorization_incorrect: Token inválido o expirado

user_id_not_configured: La integración no tiene user_id

missing_required_field: Falta un campo requerido

invalid_amount: El importe no es válido

invalid_iban: El formato del IBAN no es válido

bank_account_not_found: El usuario no tiene cuenta bancaria

bank_provider_not_configured: La cuenta no tiene proveedor configurado

external_id_already_exists: Ya existe una transferencia con ese external_id

transfer_failed: La transferencia no pudo ser procesada

unexpected_error: Error inesperado en el servidor

curl --location --request POST '/api/banking/transfer' \ --header 'auth: {{auth_token}}' \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --data-raw '{ "name": "John", "surname": "Doe", "concept": "Testing api CP", "amount": 20, "currency": "gbp", "iban": "83938362", "sort_code": "042909", "external_id": "111731777" }'

{ "status": "ok", "data": { "transaction_id": "TXN123456789", "type": "OUT", "amount": 150.50, "currency": "EUR", "date": "2024-01-15T10:30:00Z", "description": "Pago de factura 12345", "status": "completed", "from_name": null, "from_account": "410035721515", "from_bank": "easypayment", "to_name": "Juan Pérez García", "to_account": "ES1234567890123456789012", "external_id": "EXT-2024-001" } }

Solicitud

Respuestas