Transferencias
Qué es una transferencia
Sección titulada «Qué es una transferencia»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.
Listar transferencias
Sección titulada «Listar transferencias»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'] |
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'{ "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).
Movimientos de una transferencia
Sección titulada «Movimientos de una transferencia»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.
curl -X GET \'/api/v1/transfer/54/movements?per_page=15' \-H 'Authorization: Bearer ACCESS_TOKEN' \-H 'Accept: application/json'{ "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.
Estados
Sección titulada «Estados»| 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 |
{ "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." ] }}