Documentation

Merxian documentation

Merxian is a European payments platform and merchant of record. Your server creates a transaction, the buyer pays on a hosted checkout page, and Merxian sends the result to your webhook endpoint.

On this page

Start building
Understand the platform
Developer resources

A basic integration has three parts. Each part is one request or one endpoint in your system:

Your server creates a checkout session with catalog prices.
You send the buyer to the url of the session. Merxian collects the payment, and calculates tax when it applies.
Your webhook endpoint receives payment.succeeded or payment.failed.

Create a checkout session

curl -X POST https://api.merxian.com/v1/checkout-sessions \
  -H "Authorization: Bearer $MERXIAN_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "transactionDraft": {
      "currency": "EUR",
      "lineItems": [{ "priceId": "price_4Wm9TqLz2Xb7KdN8r", "quantity": 1 }]
    },
    "successUrl": "https://shop.example.com/checkout/success",
    "cancelUrl": "https://shop.example.com/checkout/cancel"
  }'

Start building

Understand the platform

Developer resources