Saltar al contenido principal
POST
Cobro activo (pull)

Autorizaciones

Authorization
string
header
requerido

JWT de sesión (de register/login) o llave de API (pk_...). X-API-Key: <token> se acepta como header alternativo.

Encabezados

Idempotency-Key
string

Alternativa al campo idempotency_key del body.

Cuerpo

application/json
method
string
requerido

Método de cobro (ej. c2p, debito_inmediato).

amount
string
requerido

Monto local como string decimal positivo.

idempotency_key
string
requerido

Obligatoria — el collect ejecuta un cargo real; reintentos con la misma clave no vuelven a cobrar.

country
string
predeterminado:VE
currency
string
predeterminado:VES
description
string
our_reference
string
payer_document
string
payer_phone
string
payer_bank
string
payer_account
string
payer_name
string
payer_account_type
string
otp
string
otp_reference
string

Respuesta

Resultado del cobro. paid: true significa que el depósito fue acreditado.

payin_id
string
kind
string
country
string
currency
string
method
string
local_amount
string
status
string
fx_rate
string
usdt_gross
string
fee
string
usdt_credited
string
paid
boolean
provider_reference
string
status_code
string
status_message
string
failure
object

Presente solo cuando el payin queda failed en cobros activos: dónde se originó el rechazo (provider = el banco del pagador, core = la validación previa al cobro) más el código y mensaje concretos.

Última modificación el 18 de julio de 2026