Posibles eventos
Eventos disponiblespayment.createdpayment.deletedpayment.rejectedpayment.approvedpayment.expiredpayment.partially_paidpayment.partial_expired
Estados de cobros
pendingcancelledapproveddeclinedin_progressrefundedexpiredpartially_paidpartial_expired
Comisión
Todos los eventospayment.* incluyen en payment.commission la comisión de payin del cobro pagado,
junto con el neto que te abonamos, para que concilies el pago sin consultar otra fuente.
object | []
Comisión del último cargo pagado del cobro. Llega como arreglo vacío (
[]) mientras el cobro no
tiene ningún cargo pagado: por ejemplo en payment.created, payment.expired o payment.deleted.Show propiedades
Show propiedades
string
Concepto de la comisión OnePay.
COMMISSION para cobros locales y COMMISSION_INTL para
tarjetas internacionales.number
Comisión OnePay en pesos, redondeada a dos decimales. Suma solo las líneas de
details cuyo
type es una comisión (COMMISSION, COMMISSION_INTL); no incluye las retenciones.string
Moneda en la que se liquidó el cargo (ej:
COP).number
Neto abonado a tu saldo en pesos: monto pagado menos todas las deducciones de
details,
retenciones incluidas. Es el valor que debes esperar en tu cuenta.array
Desglose de cada deducción aplicada al cargo. Cada entrada tiene
type, name (descripción
legible) y amount en pesos. Valores de type: COMMISSION o COMMISSION_INTL (comisión
OnePay) y, cuando aplican, TAX_RETE_FUENTE (retención en la fuente) y TAX_RETE_IVA
(retención de IVA) en pagos con tarjeta.amount y accredited_amount no son complementarios: accredited_amount descuenta también las
retenciones de tarjeta que no entran en amount. Para cuadrar el neto usa
amount pagado - suma(details[].amount) = accredited_amount.En cobros con pagos parciales,
commission refleja únicamente el último cargo pagado, no el
acumulado de todos los abonos.commission existía en el payload pero llegaba siempre en null. Desde agosto de 2026 trae el
bloque descrito arriba. El campo es aditivo: el resto del payload no cambió.Ejemplos
payment.created
{
"payment": {
"id": "99a337b3-3a7d-4e0b-b5ea-7098b562d4dd",
"source": "Renta PAZCNTPDG0 mes mayo",
"currency": "COP",
"amount": 180000,
"amount_label": "$ 180.000",
"title": "Renta PAZCNTPDG0 mes mayo",
"description": "PAZCNTPDG0",
"phone": "+573155555555",
"expiration_at": null,
"due_date": null,
"timely_payment_date": null,
"document_link": null,
"external_id": "814",
"allows": {
"cards": true,
"accounts": true,
"card_extra": false,
"realtime": false,
"pse": true,
"transfiya": true
},
"status": "pending",
"is_test": false,
"created_at": "2023-07-13T15:42:12.000000Z",
"paid_at": null,
"payment_link": "https://pagos.onepay.la/payment/99a337b3-3a7d-4e0b-b5ea-7098b562d4dd",
"redirect_url": null,
"provider_id": null,
"metadata": null,
"customer": {
"id": "4e5f6a7b-8c9d-0e1f-2345-6789abcdef01",
"first_name": "Daniela",
"last_name": "Lozano",
"email": "danielaloza@gmail.com",
"phone": "+573155555555",
"document_type": null,
"document_number": null,
"created_at": "2023-07-01T10:00:00.000000Z",
"is_test": false
},
"method": null,
"splits": [],
"company": null,
"commission": []
},
"event": {
"type": "payment.created",
"timestamp": 1689262934,
"environment": "live"
}
}
payment.approved
{
"payment": {
"id": "99a337b3-3a7d-4e0b-b5ea-7098b562d4dd",
"source": "Renta PAZCNTPDG0 mes mayo",
"currency": "COP",
"amount": 180000,
"amount_label": "$ 180.000",
"title": "Renta PAZCNTPDG0 mes mayo",
"description": "PAZCNTPDG0",
"phone": "+573155555555",
"expiration_at": null,
"due_date": null,
"timely_payment_date": null,
"document_link": null,
"external_id": "814",
"allows": {
"cards": true,
"accounts": true,
"card_extra": false,
"realtime": false,
"pse": true,
"transfiya": true
},
"status": "approved",
"is_test": false,
"created_at": "2023-07-13T15:42:12.000000Z",
"paid_at": "2023-07-13T16:05:48.000000Z",
"payment_link": "https://pagos.onepay.la/payment/99a337b3-3a7d-4e0b-b5ea-7098b562d4dd",
"redirect_url": null,
"provider_id": "TXN-987654",
"metadata": null,
"customer": {
"id": "4e5f6a7b-8c9d-0e1f-2345-6789abcdef01",
"first_name": "Daniela",
"last_name": "Lozano",
"email": "danielaloza@gmail.com",
"phone": "+573155555555",
"document_type": null,
"document_number": null,
"created_at": "2023-07-01T10:00:00.000000Z",
"is_test": false
},
"method": {
"id": "9e01eeae-2868-4564-9d04-84d1d1d027d2",
"brand": "visa",
"label": "Visa terminada en 4242",
"last_four": "4242",
"expiration_date": "12/2027",
"customer_id": "4e5f6a7b-8c9d-0e1f-2345-6789abcdef01",
"created_at": "2023-07-01T10:05:00.000000Z",
"country": "CO"
},
"splits": [],
"company": null,
"commission": {
"type": "COMMISSION",
"amount": 5720,
"currency": "COP",
"accredited_amount": 171580,
"details": [
{
"type": "COMMISSION",
"name": "Procesamiento de datos OnePay 2,9% + $500",
"amount": 5720
},
{
"type": "TAX_RETE_FUENTE",
"name": "Retención en la fuente",
"amount": 2700
}
]
}
},
"event": {
"type": "payment.approved",
"timestamp": 1689264348,
"environment": "live"
}
}
payment.partially_paid
{
"payment": {
"id": "9e5ccd4a-d2f0-49dd-87fc-a0da752bd166",
"source": "Suscripción Premium",
"currency": "COP",
"amount": 500000,
"amount_label": "$ 500.000",
"title": "Suscripción Premium",
"description": null,
"phone": "+573201112233",
"expiration_at": "2025-04-20T22:36:24.000000Z",
"due_date": null,
"timely_payment_date": null,
"document_link": null,
"external_id": null,
"allows": {
"cards": true,
"accounts": true,
"card_extra": false,
"realtime": false,
"pse": true,
"transfiya": true
},
"status": "partially_paid",
"is_test": false,
"created_at": "2025-04-15T10:00:00.000000Z",
"paid_at": null,
"payment_link": "https://pagos.onepay.la/payment/9e5ccd4a-d2f0-49dd-87fc-a0da752bd166",
"redirect_url": null,
"provider_id": null,
"metadata": null,
"customer": null,
"method": null,
"splits": [],
"company": null,
"commission": {
"type": "COMMISSION",
"amount": 6300,
"currency": "COP",
"accredited_amount": 193700,
"details": [
{
"type": "COMMISSION",
"name": "Procesamiento de datos OnePay 2,9% + $500",
"amount": 6300
}
]
},
"partial_payment": {
"total_paid_in_cents": 20000000,
"total_paid_label": "$ 200.000",
"remaining_amount_in_cents": 30000000,
"remaining_label": "$ 300.000",
"progress_percentage": 40.0,
"is_fully_paid": false,
"min_amount_in_cents": 5000000,
"max_amount_in_cents": null,
"max_payment_methods": 3,
"timeout_hours": 24,
"partial_expires_at": "2025-04-16T10:00:00+00:00",
"charges": [
{
"id": "3f8b7a21-1d4a-4d2e-8f1a-17e2f1e6b9ab",
"amount_in_cents": 20000000,
"amount_label": "$ 200.000",
"payment_method_type": "account",
"payment_method": "PSE - Bancolombia",
"paid_at": "2025-04-15T10:30:00+00:00"
}
]
}
},
"event": {
"type": "payment.partially_paid",
"timestamp": 1744714200,
"environment": "live"
}
}
payment.partial_expired
{
"payment": {
"id": "9e5ccd4a-d2f0-49dd-87fc-a0da752bd166",
"source": "Suscripción Premium",
"currency": "COP",
"amount": 500000,
"amount_label": "$ 500.000",
"title": "Suscripción Premium",
"description": null,
"phone": "+573201112233",
"expiration_at": "2025-04-20T22:36:24.000000Z",
"due_date": null,
"timely_payment_date": null,
"document_link": null,
"external_id": null,
"allows": {
"cards": true,
"accounts": true,
"card_extra": false,
"realtime": false,
"pse": true,
"transfiya": true
},
"status": "partial_expired",
"is_test": false,
"created_at": "2025-04-15T10:00:00.000000Z",
"paid_at": null,
"payment_link": "https://pagos.onepay.la/payment/9e5ccd4a-d2f0-49dd-87fc-a0da752bd166",
"redirect_url": null,
"provider_id": null,
"metadata": null,
"customer": null,
"method": null,
"splits": [],
"company": null,
"commission": {
"type": "COMMISSION",
"amount": 6300,
"currency": "COP",
"accredited_amount": 193700,
"details": [
{
"type": "COMMISSION",
"name": "Procesamiento de datos OnePay 2,9% + $500",
"amount": 6300
}
]
},
"partial_payment": {
"total_paid_in_cents": 20000000,
"total_paid_label": "$ 200.000",
"remaining_amount_in_cents": 30000000,
"remaining_label": "$ 300.000",
"progress_percentage": 40.0,
"is_fully_paid": false,
"min_amount_in_cents": 5000000,
"max_amount_in_cents": null,
"max_payment_methods": 3,
"timeout_hours": 24,
"partial_expires_at": "2025-04-16T10:00:00+00:00",
"charges": [
{
"id": "3f8b7a21-1d4a-4d2e-8f1a-17e2f1e6b9ab",
"amount_in_cents": 20000000,
"amount_label": "$ 200.000",
"payment_method_type": "account",
"payment_method": "PSE - Bancolombia",
"paid_at": "2025-04-15T10:30:00+00:00"
}
]
}
},
"event": {
"type": "payment.partial_expired",
"timestamp": 1744800600,
"environment": "live"
}
}