Skip to navigation

Pagar una planilla desde el balance

Paga a todas las personas pendientes a la vez desde el balance de la cuenta: a todas o a ninguna. El balance tiene que cubrir la planilla completa en cada moneda. Cada pago llega a la cuenta de Recurrente de la persona o, mientras no la tenga, a su WhatsApp, y aparece como transfer_id en su línea.

La primera planilla de una cuenta queda en in_review hasta que Recurrente la revisa, salvo que la cuenta tenga los retiros preaprobados; las siguientes se pagan de inmediato (paid).

Requiere una llave en vivo que pueda mover dinero y una cuenta verificada (money_movement_not_enabled, live_api_key_required, verification_required, connected_account_unverified). Un Sandbox arma el equipo y las planillas, pero no las paga (sandbox_unsupported).

Authentication

X-SECRET-KEYstring

Tu clave secreta de API.

Una llave de cuenta (sk_live_..., sk_test_...) opera sobre su propia cuenta y, con X-ACCOUNT-ID, sobre sus cuentas conectadas.

La llave también fija el ambiente: una sk_test_ solo lista y resuelve objetos de prueba (live_mode: false) y una sk_live_ solo objetos reales. Un ID del otro ambiente responde 404 (401 en /customers).

Una llave de organización (sk_org_live_..., sk_org_test_...) alcanza todas las cuentas de una organización y solo sirve para leer: saldos, movimientos y reportes. Para operar sobre una cuenta debe nombrarla con X-ACCOUNT-ID; omitirlo en una lectura devuelve todas las cuentas de la organización. Cualquier otro endpoint responde 403 con code: organization_key_unsupported.

Path parameters

payroll_run_idstringRequired

Response

La planilla pagada o en revisión

idstringOptional
account_idstringOptional
kindenumOptional
Allowed values:
labelstringOptional
statusenumOptional

draft hasta que la pagas; in_review cuando es la primera de la cuenta y espera la revisión de Recurrente; paid; cancelled.

Allowed values:
pay_ondateOptional
period_start_ondateOptional
period_end_ondateOptional
totalslist of objectsOptional

Por moneda: en un borrador, lo que pagarla tomará del balance; ya confirmada, lo que envió.

confirmed_atdatetime or nullOptional
reviewed_atdatetime or nullOptional
lineslist of objectsOptional
created_atdatetimeOptional

Errors

403
Forbidden Error
422
Unprocessable Entity Error