Transfer

（payProduct=12）

Dirección de solicitud

Nombre del entorno
URL

SandBox

POST https://api.supefina.tech/api/supefina/transactions/payout

Producción

POST https://api.supefina.net/api/supefina/transactions/payout

Formas de solicitud

Encabezado de solicitud

Key
Value

Content-Type

application/json

Cuerpo de solicitud

Nombre de variable
Tipo
Obligatorio
Descripción

countryId

String

Sí

Código del país Referencia：Tabla de diccionario-Código del país Colombia，COL

orderAmount

String

Sí

Monto del pedido 3000 <= orderAmount <= 3000000

No se admiten decimales

payProduct

String

Sí

Tipo de pago Transfer：12

merId

String

Sí

ID del comerciante

Ruta para obtener el ID del comerciante: Panel de comerciante Supefina - Gestión de comerciantes - Información básica - ID del comerciante

currency

String

Sí

Moneda Referencia：Tabla de diccionario-Moneda Peso colombiano：COP

merOrderNo

String

Sí

Número de pedido del comerciante

customerName

String

Sí

Nombre del usuario

customerAddress

String

No

Dirección del usuario

customerIdentification

String

Sí

Número de identificación del usuario

00: Cédula de ciudadanía (CC) -- máximo 10 dígitos

01: Cédula de extranjería (CE) -- 6 dígitos

sign

String

Sí

Firma Referencia específica: algoritmo de firma

nonceStr

String

Sí

Cadena aleatoria

La longitud no puede exceder 32 caracteres

customerEmail

String

Sí

Correo electrónico del usuario

lastName

String

Sí

Apellido del usuario

customerPhone

String

Sí

Teléfono del usuario

Números de 10 dígitos sin incluir el código de área

  • 3005102545

customerIdentificationType

String

Sí

Tipo de identificación de usuario 00：Cédula de Ciudadanía (CC) 01：Cédula de Extranjería (CE) 02：Número de Identificación Tributaria 03：Pasaporte 06：Otras 07：Prueba de ciudadanía 08：Permiso de residencia

accountType

String

Sí

Tipo de cuenta:

00: Cuenta corriente

01: Cuenta de ahorros

account

String

Sí

Número de cuenta del beneficiario

bankId

String

Sí

Código del Banco

Consultar la lista de bancos de Colombia

bankName

String

Sí

Nombre del banco

Consultar la lista de bancos de Colombia

callbackUrl

String

No

Dirección de callback

Consultar la instrucción de notificación de callback

requestData

JSONObject

No

Parámetros adicionales de la transacción

Este campo es un objeto JSON; si no es necesario, se puede omitir o enviar "null"

description

String

Sí

Descripción

No puede contener símbolos especiales, y la longitud no debe exceder los 200 caracteres.

Ejemplo de solicitud 

{
    "account": "3011268353",
    "accountType": "01",
    "bankId": "27",
    "bankName": "BANCOLOMBIA",
    "callbackUrl": "https://api.datasvc.link/data-service//api/skip/co/supefina/cb",
    "countryId": "COL",
    "currency": "COP",
    "customerAddress": "Unknown",
    "customerEmail": "[email protected]",
    "customerIdentification": "71706984",
    "customerIdentificationType": "00",
    "customerName": "ATTELLITIOS ORTIZ HERNANDEZ",
    "customerPhone": "3011268353",
    "lastName": "ATTELLITIOS",
    "merId": "8202165277520295",
    "merOrderNo": "COPODP81AC8NGZR5",
    "nonceStr": "QcaPbbVlqZdcmCtE",
    "orderAmount": "62876",
    "payProduct": "12",
    "sign": "0B6B721CE2A05D4D1F42997D346DBB7C",
    "description":"Supefina"
}

Parámetros de respuesta

Nombre de variable
Tipo
Descripción

code

String

Código de respuesta Referencia específica: Códigos de estado de respuesta

data

Object

Datos de respuesta

amount

BigDecimal

Monto del pedido

fee

BigDecimal

Comisión anticipada

merCode

String

ID de comerciante

merOrderNo

String

Número de pedido del comerciante

supefinaOrderNo

String

Número de pedido de Supefina

transactionStatus

String

Estado del pedido. Este estado indica si la solicitud fue exitosa, sin relación con el estado real de la transacción.

00: Pedido exitoso;

04: Pedido fallido.

msg

String

Mensaje de respuesta

Ejemplo de respuesta

{
    "code": "200",
    "data": {
        "amount": 105.00,
        "fee": 3.00,
        "merCode": "8202157333970291",
        "merOrderNo": "8485233309941743872",
        "supefinaOrderNo": "2024052001860105b0fae306a6e43",
        "transactionStatus": "00"
    },
    "msg": "success "
}

Notificación de callback

Método de envío: POST

Nombre de variable
Tipo
Descripción

amount

String

Monto del pedido

countryId

String

Código del país Referencia：Tabla de diccionario-Código del país Colombia，COL

customerName

String

Nombre del beneficiario

fee

String

Comisión anticipada

identifier

String

Referencia de pago Clabe

merId

String

ID del comerciante

merOrderId

String

Número de pedido del comerciante

msg

String

Descripción de la respuesta

nonceStr

String

Cadena aleatoria

La longitud no puede exceder 32 caracteres

realityAmount

String

Monto recibido

realityFee

String

Comisión recibida

reference

String

Identificador

sign

String

Firma

status

String

Estado de la transacción

Referencia específica: Tabla de diccionario - Estado del pedido de transacción

successTime

Date

Tiempo de éxito de la transacción

Hora UTC

supefinaOrderId

String

Número del pedido de Supefina

transactionType

String

Tipo de transacción 01：Payin 02：Payout

Ejemplo de notificación de callback

{
    "amount": "48250.00",
    "countryId": "COL",
    "customerName": "Fredi",
    "fee": "6627.25",
    "identifier": "706180968985601627",
    "merId": "8301409897370054",
    "merOrderId": "W20240617160938365CL",
    "msg": "null",
    "nonceStr": "26f919f0-f50a-45a2-b5f0-aa3901",
    "realityAmount": "48250.00",
    "realityFee": "6627.25",
    "sign": "FB19534FAD9FF7176CB809F9696BA565",
    "status": "01",
    "successTime": 1718657547294,
    "supefinaOrderId": "2024061700020017d60360e7ac647",
    "transactionType": "02"
}

Respuesta de notificación de callback

Después de que el comerciante reciba correctamente la notificación de callback, debe devolver la cadena especificada: SUCCESS. Si no se devuelve o se devuelve otro contenido, se considerará que la notificación ha fallado. Por ejemplo:

public String test(){
	return "SUCCESS";
}

Lista de bancos de payout en Colombia

bankId
bankName

6

BANCAMIA

7

BANCO AGRARIO

9

BANCO CAJA SOCIAL

10

BANCO COOPERATIVO COOPCENTRAL

11

BANCO CREDIFINANCIERA

12

BANCO DE BOGOTA

15

BANCO DE OCCIDENTE

16

BANCO FALABELLA

21

BANCO POPULAR

23

BANCO SERFINANZA

25

BANCO_GNB_SUDAMERIS

27

BANCOLOMBIA

28

BANCOOMEVA

29

BBVA

36

CITIBANK

38

COLTEFINANCIERA

40

COOFINEP

46

DAVIPLATA

47

DAVIVIENDA

62

IRIS

64

ITAU

66

LULO BANK

70

MOVII

73

NEQUI

77

PICHINCHA

82

SCOTIABANK COLPATRIA

86

DALE

87

COTRAFA

88

CFA COOPERATIVA FINANCIERA

89

BANCO UNION antes GIROS

90

BANCO SANTANDER COLOMBIA

91

BANCO AV VILLAS

AnteriorColombiaSiguienteTransfiya

Última actualización