Revendedores (marca blanca)

Si tienes tu propia app y quieres ofrecer cobros, WhatsApp y facturación a tus clientes con tu marca, das de alta a cada negocio desde tu servidor. Recaudo queda detrás: tus clientes no tienen que crear cuenta aquí.

Tu llave de revendedor

Te la damos nosotros y empieza con rpk_live_. Solo sirve para dar de alta y consultar negocios; para cobrar usas la llave sk_live_ de cada negocio, que te regresamos al crearlo. Guarda ambas en tu servidor, nunca en la app.

Dar de alta un negocio

external_id es tu identificador del negocio. Si lo repites te respondemos 409 con el código external_id_conflict, así que puedes reintentar sin miedo a duplicar.

curl -X POST https://recaudo.app/api/v1/partner/tenants \
  -H "Authorization: Bearer rpk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"external_id": "biz_123", "business_name": "Taller Ejemplo", "owner_email": "dueno@ejemplo.com", "country": "MX", "webhook_url": "https://tu-servidor.com/recaudo", "webhook_events": ["payment.succeeded", "invoice.paid"]}'

{
    "object": "partner_tenant",
    "tenant_id": "6f1c\u2026",
    "external_id": "biz_123",
    "business_name": "Taller Ejemplo",
    "country": "MX",
    "currency": "MXN",
    "timezone": "America/Mexico_City",
    "status": "active",
    "plan": "growth",
    "api_key": "sk_live_\u2026",
    "capabilities": {
        "card": {
            "available": true,
            "ready": false,
            "status": "pending"
        },
        "spei": {
            "available": true,
            "ready": false,
            "status": "pending"
        },
        "cash": {
            "available": true,
            "ready": false,
            "status": "pending"
        },
        "tap_to_pay": {
            "available": true,
            "ready": false,
            "status": "pending"
        },
        "whatsapp": {
            "available": true,
            "ready": false,
            "status": "pending"
        },
        "einvoice": {
            "available": true,
            "ready": false,
            "status": "pending"
        }
    },
    "webhook": {
        "id": "0b7e\u2026",
        "secret": "whsec_\u2026"
    }
}

Parámetros

• external_id obligatorio. Tu id del negocio (máx. 100).
• business_name obligatorio. Nombre comercial.
• owner_email obligatorio. Correo del dueño; con él puede entrar a recaudo.app si algún día lo necesita (con "olvidé mi contraseña").
• owner_name, owner_phone opcionales.
• country, currency, timezone opcionales. Por omisión MX, la moneda y la zona del país.
• plan opcional. Código del plan; por omisión growth.
• webhook_url, webhook_events opcionales. Si los mandas, creamos el webhook del negocio y te regresamos su secreto una sola vez.

Consultar un negocio

Regresa los datos y las capacidades, sin la llave.

https://recaudo.app/api/v1/partner/tenants/{external_id}

Llave nueva para un negocio

Emite otra sk_live_ y desactiva las que te habíamos dado para ese negocio.

https://recaudo.app/api/v1/partner/tenants/{external_id}/api-keys

Capacidades

Con la llave del negocio, GET /v1/capabilities dice qué puede usar hoy: card, spei, cash, tap_to_pay, whatsapp y einvoice. not_available quiere decir que no existe en su país, pending que falta darlo de alta y active que ya funciona. Úsalo para decidir qué botones enseñas.

https://recaudo.app/api/v1/capabilities

Altas que solo puede hacer el negocio

Conectar Stripe, conectar WhatsApp con Meta y subir los datos fiscales (CSD) los tiene que hacer el dueño. Con la llave del negocio pides un enlace de un solo uso (dura una hora), lo abres en el navegador de tu app y al terminar regresamos a return_url con type, success (1 o 0) y, si algo falló, message. return_url puede ser https o un esquema que nos hayas registrado (p. ej. korima://).

curl -X POST https://recaudo.app/api/v1/onboarding-links \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"type": "whatsapp", "return_url": "korima://recaudo/onboarding"}'

{
    "object": "onboarding_link",
    "type": "whatsapp",
    "url": "https://recaudo.app/admin/onboarding-link/\u2026",
    "expires_at": "2026-11-07T13:00:00-06:00"
}

type stripe · whatsapp · fiscal