Active collection (pull)
Charges the payer directly in corridors that support pull collections (e.g. Venezuela c2p / debito_inmediato). Synchronous: if the charge is approved the deposit converts at your current payin_rate and is credited in the same call, net of the payin fee. If the payer declines, paid is false, the payin is marked failed and nothing is charged.
Authorizations
Session JWT (from register/login) or API key (pk_...).
X-API-Key: <token> is accepted as an alternative header.
Headers
Alternative to the idempotency_key body field.
Body
Collection method (e.g. c2p, debito_inmediato).
Local amount as a positive decimal string.
Required — a collect executes a real charge; retries with the same key never re-charge.
Response
Collection result. paid: true means the deposit was credited.
Present only when the payin is failed on active collections: where the rejection originated (provider = the payer's bank, core = pre-charge validation) plus the concrete code and message.