Saltar al contenido principal
POST
/
v1
/
customer_portal
/
sessions
Create a customer portal session
curl --request POST \
  --url https://api.finseed.es/v1/customer_portal/sessions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "external_customer_id": "cus_9aZ"
}
'
{
  "url": "https://app.easyverifactu.com/app/customer-portal/eyJ…",
  "expires_at": "2026-06-01T10:30:00Z"
}

Autorizaciones

​
Authorization
string
header
requerido

API key sent as a bearer token in the Authorization header.

Cuerpo

application/json

The customer to create a portal session for.

Identifies the customer a portal session is created for.

​
external_customer_id
string
requerido

External customer identifier from the originating integration (for example the Stripe customer id). The portal shows the invoices that belong to this customer.

Minimum string length: 1
Ejemplo:

"cus_9aZ"

​
integration_id
string

The integration the customer belongs to. Required only when your environment has more than one integration, because the same external customer id can refer to different customers across integrations; omit it when you have a single integration. If it is required but missing, the request fails with customer_ambiguous.

Minimum string length: 1
Ejemplo:

"int_3kQ"

Respuesta

A signed link to a customer portal session.

A signed link to a customer portal session.

​
url
string
requerido

Portal URL carrying a signed, time-limited session token. Hand it to the customer so they can view their invoices without exposing your API key.

Ejemplo:

"https://app.easyverifactu.com/app/customer-portal/eyJ…"

​
expires_at
string
requerido

When the portal session stops working, RFC 3339 in UTC. Create a fresh session after this.

Ejemplo:

"2026-06-01T10:30:00Z"