Ir al contenido

Transferencias

Ver .md

Una transferencia es el envío de dinero desde tu cuenta virtual de Efipay hacia una cuenta bancaria. Es el paso final del ciclo: cobras a tus clientes, el dinero se acumula en tu cuenta virtual como movimientos, y de ahí sale al banco.

Descripción: Devuelve las transferencias asociadas a tus sucursales, paginadas. Todos los filtros son opcionales; sin filtros trae todo.

GET /api/v1/transfer

Nombre del campo Descripción Reglas
start_date Desde qué fecha, sobre la fecha de creación ['nullable', 'date_format:Y-m-d', 'before_or_equal:finish_date']
finish_date Hasta qué fecha. No puede ser futura ['nullable', 'date_format:Y-m-d', 'before_or_equal:today', 'after_or_equal:start_date']
offices Ids de las sucursales a incluir. Sin este filtro se incluyen todas las tuyas ['nullable', 'array']
offices.* Cada id debe ser de una de tus sucursales ['required', 'exists:offices,id']
GEThttps://sag.efipay.co/api/v1/transfer
Ventana de terminal
curl -X GET \
'/api/v1/transfer?start_date=2026-07-01&finish_date=2026-07-31&offices[]=1' \
-H 'Authorization: Bearer ACCESS_TOKEN' \
-H 'Accept: application/json'
200OK
{
"data": [
{
"id": "9b0f2a13-2c44-4a1a-9f2e-1d3b4c5d6e7f",
"amount": 1500000,
"transfer_charge": 7500,
"gravamen": 6000,
"total": 1486500,
"status": "Transferido",
"comments": null,
"transferable_type": "Transferencia Manual",
"transferable": {
"amount": 1500000,
"transfer_charge": 7500,
"office_id": 1,
"economic_group_id": null
},
"bankable": {
"bank_name": "Bancolombia",
"account_holder": "Comercio de Prueba S.A.S.",
"last_four_numbers": "4321",
"identification_number": "901234567",
"is_approved": true
},
"created_at": "2026-07-15T09:00:00.000000Z"
}
],
"links": {
"first": "https://sag.efipay.co/api/v1/transfer?page=1",
"last": "https://sag.efipay.co/api/v1/transfer?page=3",
"prev": null,
"next": "https://sag.efipay.co/api/v1/transfer?page=2"
},
"meta": {
"current_page": 1,
"from": 1,
"last_page": 3,
"per_page": 15,
"to": 15,
"total": 42
}
}

Qué es cada monto

Campo Significado
amount Lo que se solicitó transferir
transfer_charge Costo de la transferencia
gravamen Gravamen a los movimientos financieros (4×1000), cuando aplica
total Lo que efectivamente llegó al banco: amount − transfer_charge − gravamen
comments Nota interna. Cuando una transferencia se cancela, aquí suele estar el motivo

De dónde salió: transferable_type

Valor Qué fue
Transferencia Manual La solicitaste tú desde el panel
Transferencia Programada Salió de una programación recurrente
Transferencia a terceros Una dispersión hacia cuentas que no son la tuya

El objeto transferable cambia de forma según ese tipo, y bankable describe la cuenta de destino (last_four_numbers son los últimos cuatro dígitos; nunca devolvemos el número completo).

Descripción: Devuelve los movimientos que componen una transferencia: las ventas liquidadas que entraron en ella y el descuento del costo de la transferencia, cuando aplica. Usa el id que devuelve Listar transferencias.

GET /api/v1/transfer/{transfer}/movements

Nombre del campo Descripción Reglas
transfer Id de la transferencia, en la ruta ['required', 'integer']
per_page Cuántos movimientos por página. 15 si lo omites ['nullable', 'integer', 'min:1', 'max:100']
page Página de resultados ['nullable', 'integer', 'min:1']

Si la transferencia no es tuya, o no tiene movimientos en tus sucursales, la respuesta es 404.

GEThttps://sag.efipay.co/api/v1/transfer/54/movements
Ventana de terminal
curl -X GET \
'/api/v1/transfer/54/movements?per_page=15' \
-H 'Authorization: Bearer ACCESS_TOKEN' \
-H 'Accept: application/json'
200OK
{
"data": [
{
"id": 9012,
"description": "Trx 1485 disponible",
"date": "2025-04-22T15:20:00.000000Z",
"payment_method": "MasterCard",
"authorization_code": "435542",
"transaction_id": 1485,
"amount": 78500,
"liquidated_amount": 78175,
"rete_iva": 0,
"rete_ica": 325,
"rete_fte": 0,
"commission": 0,
"iva_commission": 0,
"fee": 0,
"iva_fee": 0,
"gravamen": 0,
"office": {
"id": 1,
"name": "Sede principal",
"description": "Punto de venta principal",
"email": "principal@mi-comercio.com",
"active": true
},
"amount_to_transfer": 78175,
"percentage_to_transfer": 1
}
],
"links": {
"first": "https://sag.efipay.co/api/v1/transfer/54/movements?page=1",
"last": "https://sag.efipay.co/api/v1/transfer/54/movements?page=1",
"prev": null,
"next": null
},
"meta": {
"current_page": 1,
"from": 1,
"last_page": 1,
"per_page": 15,
"to": 1,
"total": 1
}
}

Qué es cada monto

Campo Significado
amount Valor de la transacción, o del descuento cuando la fila es el costo de la transferencia
liquidated_amount Lo que quedó liquidado en la cuenta virtual por ese movimiento
amount_to_transfer Parte de ese movimiento que entró en esta transferencia
percentage_to_transfer Porcentaje del movimiento aplicado a esta transferencia. 1 es el 100 %

office es la sucursal del movimiento (id, name, datos de contacto y active). En el descuento por transferencia, payment_method, authorization_code y transaction_id vienen en null, y amount, liquidated_amount y amount_to_transfer salen negativos. Los movimientos vienen del más reciente al más antiguo.

Estado Qué significa
Recibido La solicitud entró y está en cola
En Proceso Se está enviando al banco
Transferido El dinero salió. Es el estado final de una transferencia exitosa
Cancelado No se realizó. El motivo suele venir en comments
422Unprocessable Entity
{
"message": "El campo finish_date debe ser una fecha anterior o igual a hoy.",
"errors": {
"finish_date": [
"El campo finish_date debe ser una fecha anterior o igual a hoy."
]
}
}

Última actualización: