Skip to navigation

Configurar quién paga las comisiones de una cuenta conectada

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.

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

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

Allowed values:

Response

Responsabilidad actualizada
fees_collectorenum

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

Allowed values:
override_fees_collectorenum or null

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

Allowed values:
default_fees_collectorenum

Configuración general de responsabilidad de la plataforma

Allowed values:

Errors

400
Bad Request Error
403
Forbidden Error
404
Not Found Error