Card Payments

Server-to-server (S2S) charging lets your backend send card details directly to Axra. It puts your servers in PCI DSS scope, so it is off by default — approval of your business account does not enable it.

Most integrations do not need S2S. Checkout sessions and payment links keep card data on Axra’s hosted page, which keeps you out of PCI scope. Those work on every approved account with no extra step.

Check whether it’s enabled

GET /v1/business/config returns your current entitlement:

curl https://api.useaxra.com/v1/business/config \
  -H "x-api-key: YOUR_API_KEY"

{
  "id": "…",
  "businessName": "…",
  "isActive": true,
  "s2sChargingEnabled": false
}

If s2sChargingEnabled is false, contact support to request access. Charging before it is granted returns 403:

{
  "statusCode": 403,
  "message": "Server-to-server card charging is not enabled for this business. Use a checkout session or payment link, or contact support to request access."
}

Charge a card

curl -X POST https://api.useaxra.com/v1/business/payment/charge \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 50.00,
    "currency": "USD",
    "card": {
      "number": "4111111111111111",
      "expiryMonth": "12",
      "expiryYear": "2030",
      "cvv": "123",
      "holderName": "Jane Doe"
    },
    "customerIp": "203.0.113.42",
    "email": "jane@example.com",
    "returnUrl": "https://your-site.example/order/1234/complete"
  }'

customerIp must be your customer’s IP address, not your server’s. It feeds risk scoring and the 3DS authentication request; sending your own IP degrades both.

3DS handling

If the card requires 3D Secure, the response comes back with requiresAction and a redirectUrl. Send the customer there, then confirm via POST /v1/business/payment/confirm-3ds. See the 3DS guide for the full flow. Confirming and refunding are not gated on the S2S entitlement, so a charge already in flight always completes.

API Reference

See full endpoint documentation.

Payments

Treasury

Webhooks

SDKs

Card Payments

Check whether it’s enabled

Charge a card

3DS handling

API Reference

​Check whether it’s enabled

​Charge a card

​3DS handling

API Reference

Check whether it’s enabled

Charge a card

3DS handling