curl --request GET \
--url https://api.cobrix.co/api/integrations/v1/{companyId}/payment-verifications/{verificationId} \
--header 'Authorization: Bearer <token>' \
--header 'Cobrix-Signature: <cobrix-signature>' \
--header 'Cobrix-Timestamp: <cobrix-timestamp>'const options = {
method: 'GET',
headers: {
'Cobrix-Timestamp': '<cobrix-timestamp>',
'Cobrix-Signature': '<cobrix-signature>',
Authorization: 'Bearer <token>'
}
};
fetch('https://api.cobrix.co/api/integrations/v1/{companyId}/payment-verifications/{verificationId}', 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/{verificationId}"
headers = {
"Cobrix-Timestamp": "<cobrix-timestamp>",
"Cobrix-Signature": "<cobrix-signature>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text){
"id": "0b6e2f4a-7c1d-4e8b-9a3f-5d2c1b0a9e87",
"method": "pago_movil",
"status": "verified",
"reason": null,
"warnings": [],
"reference": "••••3456",
"amountMinor": 150000,
"currency": "VES",
"paymentDate": "2026-11-12",
"bank": {
"amountMinor": 150000,
"valueDate": "2026-11-12"
},
"receiverAccountKey": "bank:3d9a7c52-1e4b-4f6a-8c2d-7b5e9f1a0c34",
"externalReference": "PED-1001",
"metadata": null,
"createdAt": "2026-11-13T12:00:00.000Z",
"resolvedAt": "2026-11-13T12:00:01.000Z",
"resolvedBy": "bank",
"reviewNote": null,
"tokenId": null
}{
"error": {
"code": "invalid_request",
"message": "amountMinor must not be less than 1",
"field": "amountMinor",
"details": [
{
"field": "amountMinor",
"message": "amountMinor must not be less than 1"
}
],
"requestId": "req-1001"
}
}{
"error": {
"code": "invalid_api_key",
"message": "The API key is missing or invalid.",
"requestId": "req-1001"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"requestId": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"requestId": "<string>"
}
}{
"error": {
"code": "rate_limited",
"message": "Too many requests for this API key.",
"requestId": "req-1001"
}
}{
"error": {
"code": "internal_error",
"message": "Something failed on our side. Try again in a few minutes; if it keeps failing, contact Cobrix support.",
"requestId": "req-1001"
}
}Consultar validación
El estado actual de una validación. Úsalo para saber si un Zelle en pending_review ya se resolvió.
curl --request GET \
--url https://api.cobrix.co/api/integrations/v1/{companyId}/payment-verifications/{verificationId} \
--header 'Authorization: Bearer <token>' \
--header 'Cobrix-Signature: <cobrix-signature>' \
--header 'Cobrix-Timestamp: <cobrix-timestamp>'const options = {
method: 'GET',
headers: {
'Cobrix-Timestamp': '<cobrix-timestamp>',
'Cobrix-Signature': '<cobrix-signature>',
Authorization: 'Bearer <token>'
}
};
fetch('https://api.cobrix.co/api/integrations/v1/{companyId}/payment-verifications/{verificationId}', 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/{verificationId}"
headers = {
"Cobrix-Timestamp": "<cobrix-timestamp>",
"Cobrix-Signature": "<cobrix-signature>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text){
"id": "0b6e2f4a-7c1d-4e8b-9a3f-5d2c1b0a9e87",
"method": "pago_movil",
"status": "verified",
"reason": null,
"warnings": [],
"reference": "••••3456",
"amountMinor": 150000,
"currency": "VES",
"paymentDate": "2026-11-12",
"bank": {
"amountMinor": 150000,
"valueDate": "2026-11-12"
},
"receiverAccountKey": "bank:3d9a7c52-1e4b-4f6a-8c2d-7b5e9f1a0c34",
"externalReference": "PED-1001",
"metadata": null,
"createdAt": "2026-11-13T12:00:00.000Z",
"resolvedAt": "2026-11-13T12:00:01.000Z",
"resolvedBy": "bank",
"reviewNote": null,
"tokenId": null
}{
"error": {
"code": "invalid_request",
"message": "amountMinor must not be less than 1",
"field": "amountMinor",
"details": [
{
"field": "amountMinor",
"message": "amountMinor must not be less than 1"
}
],
"requestId": "req-1001"
}
}{
"error": {
"code": "invalid_api_key",
"message": "The API key is missing or invalid.",
"requestId": "req-1001"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"requestId": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"requestId": "<string>"
}
}{
"error": {
"code": "rate_limited",
"message": "Too many requests for this API key.",
"requestId": "req-1001"
}
}{
"error": {
"code": "internal_error",
"message": "Something failed on our side. Try again in a few minutes; if it keeps failing, contact Cobrix support.",
"requestId": "req-1001"
}
}Headers
Path Parameters
Response
La validación
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 
