curl --request POST \
--url https://api.cobrix.co/api/integrations/v1/{companyId}/payment-verifications \
--header 'Authorization: Bearer <token>' \
--header 'Cobrix-Signature: <cobrix-signature>' \
--header 'Cobrix-Timestamp: <cobrix-timestamp>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"method": "pago_movil",
"reference": "000123456",
"amountMinor": 150000,
"paymentDate": "2026-11-12"
}
'const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
'Cobrix-Timestamp': '<cobrix-timestamp>',
'Cobrix-Signature': '<cobrix-signature>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
method: 'pago_movil',
reference: '000123456',
amountMinor: 150000,
paymentDate: '2026-11-12'
})
};
fetch('https://api.cobrix.co/api/integrations/v1/{companyId}/payment-verifications', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.cobrix.co/api/integrations/v1/{companyId}/payment-verifications"
payload = {
"method": "pago_movil",
"reference": "000123456",
"amountMinor": 150000,
"paymentDate": "2026-11-12"
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"Cobrix-Timestamp": "<cobrix-timestamp>",
"Cobrix-Signature": "<cobrix-signature>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)Validar un pago
Valida un pago que recibió la empresa. Pago móvil y transferencia: Cobrix consulta al banco y responde el resultado en esta llamada. Zelle: queda en pending_review hasta que una persona de la empresa lo aprueba o lo rechaza en el panel de Cobrix. Un resultado negativo no es un error HTTP: responde 201 con su status. Toda respuesta 201 se guarda con su Idempotency-Key: la misma clave con el mismo cuerpo devuelve esa respuesta y no consulta al banco otra vez. Para consultar de nuevo, usa una clave nueva. La moneda es la de la cuenta receptora: otra responde 422 invalid_field. El límite es 60 solicitudes por minuto por llave.
curl --request POST \
--url https://api.cobrix.co/api/integrations/v1/{companyId}/payment-verifications \
--header 'Authorization: Bearer <token>' \
--header 'Cobrix-Signature: <cobrix-signature>' \
--header 'Cobrix-Timestamp: <cobrix-timestamp>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"method": "pago_movil",
"reference": "000123456",
"amountMinor": 150000,
"paymentDate": "2026-11-12"
}
'const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
'Cobrix-Timestamp': '<cobrix-timestamp>',
'Cobrix-Signature': '<cobrix-signature>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
method: 'pago_movil',
reference: '000123456',
amountMinor: 150000,
paymentDate: '2026-11-12'
})
};
fetch('https://api.cobrix.co/api/integrations/v1/{companyId}/payment-verifications', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.cobrix.co/api/integrations/v1/{companyId}/payment-verifications"
payload = {
"method": "pago_movil",
"reference": "000123456",
"amountMinor": 150000,
"paymentDate": "2026-11-12"
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"Cobrix-Timestamp": "<cobrix-timestamp>",
"Cobrix-Signature": "<cobrix-signature>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)Headers
Body
Cada campo acepta solo el tipo JSON de su esquema; Cobrix no convierte tipos.
La cuenta de la empresa que recibió el pago, de GET payment-verifications/receiver-accounts. Obligatoria en pago_movil y bank_transfer. Opcional en zelle: si la empresa tiene una sola cuenta Zelle, Cobrix usa esa.
^(pago_movil|pago_movil_method|bank|zelle):[0-9a-f-]{36}$Response
La validación con su resultado
Una validación. También es el data de los webhooks payment_verification.verified y payment_verification.rejected.
verified: el banco confirmó el pago, o una persona de la empresa aprobó el Zelle. not_found: el banco no tiene un pago con esos datos. mismatch: el banco rechazó el pago porque un dato no coincide; ver reason. already_used: la referencia ya se usó en otra validación de la empresa. ambiguous: más de un pago coincide y no se marcó ninguno. unverifiable: no se pudo consultar al banco; ver reason. pending_review: Zelle en revisión, sin vencimiento. rejected: una persona de la empresa rechazó el Zelle. Solo pending_review cambia después.
verified, not_found, mismatch, already_used, ambiguous, unverifiable, pending_review, rejected Por qué no quedó verified. En mismatch: amount_mismatch, date_mismatch, phone_mismatch, document_mismatch, bank_mismatch, duplicate_reference, already_reconciled o bank_rejected. En unverifiable: bank_unavailable, payment_too_old, invalid_payer_data o provider_misconfigured. En already_used: reference_already_used. En ambiguous: multiple_matches. En rejected: rejected_by_reviewer.
Solo en verified. already_recorded_in_cobrix: Cobrix ya tiene un pago de la empresa con esa referencia aplicado a un documento de cobro. pending_in_cobrix: Cobrix tiene un pago con esa referencia esperando aprobación. bank_amount_differs: el banco informó un monto distinto de amountMinor.
already_recorded_in_cobrix, pending_in_cobrix, bank_amount_differs 
