Portal de facturación de Stripe
POSThttps://api.cfdi.express/v1/billing/portal_sessionsAPI key
Crea una sesión del Billing Portal de Stripe para que el usuario administre métodos de pago y descargue recibos.
No recibe cuerpo. Redirige al usuario a la url devuelta; la sesión expira sola.
Autenticación
Authorization: Bearer sk_test_... | sk_live_...El header x-account-id indica la cuenta. Si no eres miembro, la respuesta es 403.
Ejemplos
cURL
curl -X POST https://api.cfdi.express/v1/billing/portal_sessions \
-H "Authorization: Bearer sk_live_..."Respuesta
201 Created
{
"object": "portal_session",
"url": "https://billing.stripe.com/p/session/live_YWNjd1..."
}Errores
| Status | code | Cuándo aparece |
|---|---|---|
| 401 | unauthorized | Falta el header Authorization o la llave es inválida. |
| 403 | forbidden | No eres miembro de la cuenta del header x-account-id. |
| 403 | forbidden | Un miembro no puede comprar saldo ni abrir el portal de facturación. Eso queda en solo lectura; lo hace el dueño del workspace. |
| 503 | billing_unavailable | El cobro con tarjeta no está configurado en este ambiente. |
Notas
- Desde la v1.38.0 un miembro ve la facturación en solo lectura. Este POST responde 403. La guía del equipo: Equipo y workspaces.