Credenciales de Acceso

1.1 Debes asociar la cantidad de códigos únicos y terminales para que puedas usarlos en la transferencia.

Consume la API Bóveda

Descarga SDK.

Para descargar los archivos SDK, envíe una solicitud dando clic AQUÍ.

Consumir servicio transaccional

2.1 Consume el servicio simpleTransfer donde se realiza la transferencia.

• URL Pruebas: https://apiadmin.apps-pruebas.credibanco.com/testing/api-p2p-gateway/api/v1/transfers/simpleTransfer

• Método HTTP: POST

Campo Descripción
sender Persona que envía el dinero.
recipient Persona que recibe el dinero.
name Primer nombre.
lastName Primer apellido.
documentType Tipo de documento (1=CC,4=CE).
documentNumber Número de identificación del tarjeta habiente
phone Número de teléfono.
cardNumber Número de tarjeta, PAN
email Correo electrónico.
expDate Fecha de expiración de la tarjeta, el formato es yyyy/mm
processor Franquicia de la tarjeta utilizada, los dos posibles valores son VISA_V1 o por defecto MASTERCARD_V1
amount Valor para enviar en COP (Peso colombiano)
transactionalQueryIdentifier Identificador para consulta transaccional en formato yyyyMMddHHmmssSSS, las horas son en formato 24H
merchantUniqueCode Código único del comercio
merchantTerminalcode Terminal del comercio

Campo Descripción
statusCode Código de resultado de transacción.
message Mensaje de resultado de transacción.
pullTransferID Campo retornado por finix para hacer la anulación de la AFT aparece cuando la transacción pull es ok y falla la transacción push.
transactionType Código para identificar en que proceso fallo si
PULL O PUSH.
messageTransfer Mensaje error.
apiError Aplica si existe error en el api de Finix.
numberStepError Aplica si fallo en algún paso especifico de Finix.

Campo Descripción
statusCode Código de resultado de transacción, es un valor entero.
message Mensaje de resultado de transacción. Es una string
pullTransferID Campo retornado por Finix para hacer la anulación de la AFT. Es una string
pushTransferID Código de autorización una vez hecha la OCT Es una string

Http-StatusCode Code Message
200 200 Transferencia exitosa.
500 500 Transferencia fallida.
500 1 Servicio no disponible.
500 2 No pudimos procesar él envió de tu dinero algo está pasando con la cuenta del destinatario.
500 3 No pudimos procesar él envió de tu dinero algo está pasando con tu cuenta.
500 4 Error reversando el envió del dinero.
500 5 Error conectando a finix.

Consulta de las transferencias realizadas.

3.1 Consumir el servicio transferByCanalSSOAndIdTransactionalQuery

• URL Pruebas: https://apiadmin.apps-pruebas.credibanco.com/testing/api-p2p/api/v1/transfers/transferByCanalSSOAndIdTransactionalQuery

• Método HTTP: GET

• Campos de entrada: Se requiere el parámetro transactionalQueryIdentifier que es el identificador que se ingresa en el servicio persontoperson

Http-StatusCode statusCode Message
400-Bad request 10 El identificador de la consulta transaccional no tiene el formato valido, el formato correcto es yyyyMMddHHmmssSSS
409-Conflict 11 No se logró obtener el canal-sso
409 66 El identificador de la consulta transaccional no existe para ese canal
102- PROCESSING 3 Pendiente por hacer el PUSH-OCT
102 4 Pendiente por hacer el REVERSO-AFT
409 5 No existen transferencias realizadas bajo ese criterio

3.2 Consumir el servicio searchTransfersInIntervalDates

• URL Pruebas: https://apiadmin.apps-pruebas.credibanco.com/testing/api-p2p/api/v1/transfers/searchTransfersInIntervalDates

• Método HTTP: GET

• Campos de entrada: El formato para los campos fecha inicio y fecha final son “dd-MM-yyyy HH:mm” “día-mes-año Hora:minuto”, la hora es en formato 24H.

Http-StatusCode statusCode Message
409-Conflict 1 No se logró obtener el canal-sso
400-Bad request 2 La fecha inicial no puede ser mayor a la final
400 3 La fecha final no puede ser menor a la inicial
409 4 La búsqueda supera la máxima cantidad días
400 5 El formato de fecha no es correcto, el formato correcto es dd-MM-yyyy HH:mm
409 6 No existen transferencias realizadas bajo ese criterio

• Link de la colección de P2P-Gateway:

DEPENDENCIAS P2P-Gateway con PCI

DEPENDENCIAS DEL SERVICIO transferByCanalSSOAndIdTransactionalQuery

El servicio no tiene dependencias de ningún servicio en particular para consumirlo correctamente

1. Consulta por intervalos de fecha (searchTransfersInIntervalDates)

1.1. Ingresa al servicio searchTransfersInIntervalDates

1.2. Parametrizar el campo fechaInicial con formato dd-MM-yyyy HH:mm

1.3. Parametrizar el campo fechaFinal con formato dd-MM-yyyy HH:mm

DEPENDENCIAS DEL SERVICIO searchTransfersInIntervalDates

El servicio no tiene dependencias de ningún servicio en particular para consumirlo correctamente.

Collection

P2P Gateway (Con PCI) - Para descargar el collection, haga un clic AQUÍ.

Certificación

Para iniciar el proceso de Certificación, debes haber finalizado tu implementación con éxito. Inicia tu solicitud AQUÍ.

Glosario

Puedes consultar el glosario dando clic AQUÍ.

Indefinido