Desarrolladores

Iniciar un pago

POST
/billing/checkout

Crea un pedido de un plan o de un paquete de créditos y devuelve checkout_url, la página donde la persona paga: el Checkout alojado de Stripe o, con PayPal, nuestra página que aloja la aprobación de PayPal para ese pedido. Abrirla no cobra nada; los créditos llegan solo cuando el proveedor de pagos confirma el pago.

Envía una cabecera Idempotency-Key para que los reintentos sean seguros: la misma clave con el mismo cuerpo devuelve el primer resultado; con otro cuerpo, 409.

Autorización

headerAutorizaciónBearer <token>

Una API Key creada en la configuración de la cuenta, enviada como Authorization: Bearer <key>. Incluye los Scopes seleccionados al crearla.

Parámetros de cabecera

Idempotency-Key?string

Una clave del cliente, única por solicitud.

Longitud1 <= length <= 255

Cuerpo de la solicitud

application/json
  1. body
providerCode*string
Valor en"stripe""paypal"
selection*|

Cuerpo de la respuesta

Correcto.

application/json
  1. response
provider*string
Valor en"stripe""paypal"
checkout_url*string
Formatouri
order_no*string
Solicitud de ejemplo
curl -X POST 'https://ximagesplitter.com/api/v1/billing/checkout' \
  -H 'Content-Type: application/json' \
  -d '{
  "providerCode": "stripe",
  "selection": {
    "planId": "starter",
    "billingCycle": "monthly",
    "purchaseKind": "plan"
  }
}'
Respuesta de ejemplo
{
  "provider": "stripe",
  "checkout_url": "http://example.com",
  "order_no": "string"
}