Crear Destinatario (ACH)

Visión General

Este endpoint permite a las entidades crear un nuevo destinatario ACH, el cual podrá ser utilizado únicamente para operaciones relacionadas con ACH (por ejemplo, dispersión ACH). Los destinatarios creados mediante este endpoint no pueden utilizarse para pagos Bre-B, flujos de QR ni para ningún otro producto.

El destinatario puede representar una PERSONA NATURAL (INDIVIDUAL) o una EMPRESA (BUSINESS) y debe incluir la información de identificación y los datos bancarios requeridos para una transferencia ACH.

Detalles del Endpoint

Parámetro	Descripción
Endpoint	https://api.paas.sandbox.co.passportfintech.com/v1/recipients/ach
Método	POST
Encabezados	Content-Type: application/json, Authorization
Autenticación	Token de Acceso (Bearer Token)

Cuerpo de la Solicitud

Parámetro	Tipo	Restricciones	Requerido	Descripción
customer_id	String	N/A	Sí	Identificador único del cliente de la entidad que crea el destinatario.
alias	String	[0-128]	No	Nombre o etiqueta amigable para identificar al destinatario ACH. Ej: “Pepito SAS5”.
owner	Objeto		Si	Información sobre el destinatario.
type	String	`BUSINESS` o `INDIVIDUAL`	Sí	Tipo de destinatario.
first_name	String		Condicional	Primero nombre del destinatario. Necesario si el `type` es INDIVIDUAL.
second_name	String		No	Segundo nombre del destinatario. Opcional si el `type` es INDIVIDUAL.
first_last_name	String		Condicional	Primero apellido del destinatario. Requerido si el `type` es INDIVIDUAL.
second_last_name	String		No	Segundo apellido del destinatario. Opcional si el `type` es INDIVIDUAL.
business_name	String		Condicional	Nombre Legal de la empresa Es necesario si el tipo es `BUSINESS`.
identification_type	String	`CC`, `CE`, `NUIP`, `PPT`, `PEP`, `NIT`, `PAS`, `TDI`	Sí	Tipo de identificación. CC: Cédula de Ciudadanía CE: Cédula de Extranjería NUIP: Número Único de Identificación Personal PPT: Permiso por Protección Temporal PEP: Permiso Especial de Permanencia NIT: Número de Identificación Tributaria PAS: Pasaporte TDI: Tarjeta de Identidad
identification_number	String		Sí	Numero del documento.
account	Objeto		Sí	Detalles de la cuenta del destinatario.
account_type	String	`LOW_VALUE`, `ORDINARY`, `CHECKING`, `SAVINGS`, `INCLUSIVE_LOW_VALUE`	Sí	Tipo de cuenta ACH.
account_number	String	[1-18]	Sí	Número de cuenta bancaria para ACH
participant	Objeto		Sí	Detalles del banco del destinatario.
name	String	Ver lista de bancos abajo.	Sí	Nombre del banco del destinatario (sensible a mayúsculas)

Listado de Bancos

Nombre de los Bancos
PAYCASH
BANCO AV VILLAS
BANCO CAJA SOCIAL
BANCO CITIBANK COLOMBIA
ITAU BANCO CORPBANCA
DAVIVIENDA
BANCO DE BOGOTA
BANCO W SA
BANCO DE OCCIDENTE
BANCO FINANDINA
BANCO GNB SUDAMERIS
BANCO MUNDO MUJER
BANCO PICHINCHA S.A
BANCO POPULAR
BANCO PROCREDIT
BANCO SANTANDER DE NEGOCIOS
BANCOLDEX
BANCOLOMBIA
BANCOOMEVA
BBVA
CONFIAR
BANCO COOPERATIVO COOPCENTRAL
COTRAFA ENTIDAD FINANCIERA
CFA FINANCIERA ANTIOQUIA
ITAU* HELM BANK
FINANCIERA JURISCOOOP CF
SCOTIABANK COLPATRIA
BANCO FALABELLA
MIBANCO
BANCAMIA S.A
BANCO CREDIFINANCIERA SA
BANCO SERFINANZA SA
BANCO UNION
NEQUI
DAVIPLATA
PIBANK
MOVII
COLTEFINANCIERA
IRIS
J.P. MORGAN COLOMBIA
LULO BANK S.A.
BANCO BGT PACTUAL
UALA
JFK COOPERATIVA FINANCIERA
POWWI
RAPPIPAY
COINK
BOLD CF
GLOBAL66
NU
DING TECNIPAGOS SA
BNP PARIBAS COLOMBIA
BANCO CONTACTAR S.A
BANCO AGRARIO
CREZCAMOS
KOA C.F
CREDIFAMILIA

Ejemplo de Solicitud

curl --location --request POST 'https://api.paas.sandbox.co.passportfintech.com/v1/recipients/ach' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer 55909b2dcfebcc77b913f046a6e25221727913d354a8585fc10f019366fe747f' \ --data '{ "customer_id": "bfdcdded-0cc2-4cda-b2d2-1681c667a879", "alias": "Personal Loan Account", "owner": { "type" : "BUSINESS", "business_name": "Passport Software SAS", "identification_type": "NIT", "identification_number": "333556747" }, "account": { "account_type": "ORDINARY", "account_number": "8809090909" }, "participant": { "name": "BANCOLOMBIA" } }'

Cuerpo de la Respuesta

Código HTTP: 200 OK
Retorna los datos del destinatario creado junto con su ID único.

Ejemplo de Respuesta

{ "customer_id": "bfdcdded-0cc2-4cda-b2d2-1681c667a879", "alias": "Home Loan Account", "participant": { "name": "BANCOLOMBIA", "identification_number": "" }, "account": { "account_type": "ORDINARY", "account_number": "8809090909" }, "type": "ACH", "owner": { "type": "BUSINESS", "identification_type": "NIT", "identification_number": "333556747", "business_name": "Passport Software SAS" }, "id": "478b5ebe-290a-464b-9acf-352e70e2143d", "created_at": "2026-03-10T17:01:35.849Z", "updated_at": "2026-03-10T17:01:35.849Z" }

Nota

El campo id es el identificador único del destinatario, que se utilizará para futuras transacciones.

Errores Comunes y Manejo

Código HTTP	Significado	Descripción
400 Bad Request	Datos inválidos	Faltan campos requeridos o contienen valores incorrectos.
401 Unauthorized	Token inválido	El token de acceso ha expirado o es inválido.
403 Forbidden	Acceso denegado	La solicitud no está autorizada para validar crear un destinatario.
500 Server Error	Error del servidor	Se produjo un error inesperado durante la creación del destinatario.

Buenas Prácticas

Verifica que el customer_id pertenezca a un cliente válido.
Valida los datos de identificación del destinatario antes de enviarlos.

Última actualización el