Cuentas Conectadas

Si estás construyendo una plataforma o un marketplace, y quieres:

• Cobrar en nombre de alguien más, o
• Compartir los ingresos de las ventas con otras cuentas

La funcionalidad de Cuentas Conectadas es para ti.

Con Cuentas Conectadas puedes realizar cobros en nombre de otras cuentas utilizando tus propias Llaves API, sin necesidad de acceder ni utilizar las llaves API de esas cuentas.

¿Cómo conecto dos cuentas?

Esto se debe hacer a través del UI de Recurrente. Sigue las instrucciones aquí.

Crear un checkout para una cuenta conectada

Una vez conectadas las cuentas, puedes crear checkouts en nombre de la cuenta hija usando el parámetro custom_account_id:

$
curl -X POST https://app.recurrente.com/api/checkouts \
>
  -H "X-PUBLIC-KEY: tu_llave_publica" \
>
  -H "X-SECRET-KEY: tu_llave_privada" \
>
  -H "Content-Type: application/json" \
>
  -d '{
>
    "items": [
>
      {
>
        "currency": "GTQ",
>
        "amount_in_cents": 3000,
>
        "name": "Producto ejemplo"
>
      }
>
    ],
>
    "custom_account_id": "ac_123456"
>
  }'

Distribución de fondos

Puedes distribuir los fondos entre cuentas usando transfer_setups:

1
{
2
  "items": [
3
    {
4
      "currency": "GTQ",
5
      "amount_in_cents": 3000,
6
      "name": "Producto ejemplo"
7
    }
8
  ],
9
  "custom_account_id": "ac_123456",
10
  "transfer_setups": [
11
    {
12
      "amount_in_cents": 100,
13
      "recipient_id": "ac_789012"
14
    }
15
  ]
16
}

Webhooks

Cuando ocurren eventos en una cuenta hija, recibirás webhooks con los parámetros adicionales:

• connected: true — indica que el evento fue generado por una cuenta conectada
• account_id: "ac_123456" — el ID de la cuenta que generó el evento

Con estos campos puedes identificar y procesar eventos de cuentas conectadas por separado.