Create Hosted Checkout sessions - SimplePay Docs

Hosted Checkout keeps sensitive payment collection outside your application. Your backend creates a session and receives its public SimplePay URL.

Select the amount source

Send exactly one option:

manual_amount: amount in the currency’s minor unit
catalog_line_item: snapshot generated by Digital Catalog

Do not send both fields.

Create a session

curl -sS -X POST "$SIMPLEPAY_API_BASE/v1/hosted-checkout/sessions" \
  -H "Authorization: Bearer $SIMPLEPAY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order_2001_checkout_v1" \
  --data '{
    "manual_amount": 149900,
    "currency": "mxn",
    "payment_method_types": ["card", "spei", "oxxo"],
    "metadata": {"order_id": "order_2001"}
  }'

Store id, public_reference, url, amount, currency, and your order reference. The redirect is a user experience signal, not financial confirmation. Process a webhook or perform an authenticated read.

Last modified on August 22, 2026