curl --request POST \
--url https://api.cobrix.co/api/integrations/v1/{companyId}/payment-verifications/tokens \
--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 '
{
"receiverAccountKey": "bank:3d9a7c52-…",
"amountMinor": 150000,
"externalReference": "PED-1001"
}
'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({
receiverAccountKey: 'bank:3d9a7c52-…',
amountMinor: 150000,
externalReference: 'PED-1001'
})
};
fetch('https://api.cobrix.co/api/integrations/v1/{companyId}/payment-verifications/tokens', 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/tokens"
payload = {
"receiverAccountKey": "bank:3d9a7c52-…",
"amountMinor": 150000,
"externalReference": "PED-1001"
}
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){
"id": "0f8fad5b-…",
"token": "pvt_0f8f…_secret_…",
"expiresAt": "2026-11-17T12:15:00.000Z",
"maxAttempts": 5,
"methods": [
"pago_movil",
"bank_transfer"
],
"amountMinor": 150000,
"currency": "VES",
"externalReference": "PED-1001"
}{
"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": "method_not_available",
"message": "The receiver account does not accept every requested method.",
"field": "methods",
"methods": [
"pago_movil"
]
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"requestId": "<string>"
}
}{
"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"
}
}Emitir un token de validación embebida
Emite un token para un pedido. Tu web se lo pasa a checkout.js y tu cliente escribe la referencia de su pago en tu página, sin ver tu llave. Cuenta receptora, monto, moneda, métodos, externalReference y metadata quedan fijos en el token: el navegador no puede cambiarlos. La moneda es la de la cuenta receptora: otra responde 422 invalid_field. token solo vuelve en esta respuesta. La misma Idempotency-Key con el mismo cuerpo devuelve el mismo token, aunque ya haya caducado, se haya revocado o se haya usado: para un token nuevo, usa otra clave. Requiere al menos una web registrada en el panel. El límite es 60 solicitudes por minuto por llave.
curl --request POST \
--url https://api.cobrix.co/api/integrations/v1/{companyId}/payment-verifications/tokens \
--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 '
{
"receiverAccountKey": "bank:3d9a7c52-…",
"amountMinor": 150000,
"externalReference": "PED-1001"
}
'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({
receiverAccountKey: 'bank:3d9a7c52-…',
amountMinor: 150000,
externalReference: 'PED-1001'
})
};
fetch('https://api.cobrix.co/api/integrations/v1/{companyId}/payment-verifications/tokens', 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/tokens"
payload = {
"receiverAccountKey": "bank:3d9a7c52-…",
"amountMinor": 150000,
"externalReference": "PED-1001"
}
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){
"id": "0f8fad5b-…",
"token": "pvt_0f8f…_secret_…",
"expiresAt": "2026-11-17T12:15:00.000Z",
"maxAttempts": 5,
"methods": [
"pago_movil",
"bank_transfer"
],
"amountMinor": 150000,
"currency": "VES",
"externalReference": "PED-1001"
}{
"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": "method_not_available",
"message": "The receiver account does not accept every requested method.",
"field": "methods",
"methods": [
"pago_movil"
]
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"requestId": "<string>"
}
}{
"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
Body
Cada campo acepta solo el tipo JSON de su esquema; Cobrix no convierte tipos.
El pedido que el token deja fijo. Cada campo acepta solo el tipo JSON de su esquema. Un campo que no está aquí responde 400 invalid_request.
Los métodos que tu cliente puede usar. Solo métodos que trae la cuenta en GET payment-verifications/receiver-accounts: pago_movil en una cuenta bancaria (bank:…) sin teléfono receptor conocido responde 422 method_not_available. Por defecto, todos los de la cuenta.
pago_movil y bank_transfer: Cobrix consulta al banco. zelle: lo revisa una persona de la empresa.
pago_movil, bank_transfer, zelle Response
El token emitido

