Configurar quién paga las comisiones de una cuenta conectada

PUT

https://app.recurrente.com/api/connected_accounts/:connected_account_id/fee_collection

application y recurrente establecen un override para esta conexión; default elimina el override. application requiere una API key live y NIT y nombre fiscal verificados en la plataforma, y aplica únicamente a cobros live en GTQ o USD. Solo cambia las comisiones de procesamiento y de Recurrente: la cuenta conectada conserva su retención, fee FEL, facturación de venta, reembolsos y disputas. La responsabilidad se guarda en cada cobro pagado.

`application` y `recurrente` establecen un override para esta conexión; `default` elimina el override. `application` requiere una API key live y NIT y nombre fiscal verificados en la plataforma, y aplica únicamente a cobros live en GTQ o USD. Solo cambia las comisiones de procesamiento y de Recurrente: la cuenta conectada conserva su retención, fee FEL, facturación de venta, reembolsos y disputas. La responsabilidad se guarda en cada cobro pagado.

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.

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.

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. 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

connected_account_idstringRequired

ID de la cuenta conectada

Request

This endpoint expects an object.

fees_collectorenumRequired

application o recurrente establecen un override; default vuelve a heredar

Response

Responsabilidad actualizada

fees_collectorenum

Responsabilidad efectiva después de aplicar el override o el valor general

override_fees_collectorenum or null

Override de la conexión; null significa que hereda la configuración general

default_fees_collectorenum

Configuración general de responsabilidad de la plataforma

Errors

400

Bad Request Error

403

Forbidden Error

404

Not Found Error

$	curl -X PUT https://app.recurrente.com/api/connected_accounts/connected_account_id/fee_collection \
>	-H "X-SECRET-KEY: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"fees_collector": "application"
>	}'