Create payment

Creates a generic developer payment request. This endpoint does not create fulfillable product delivery. Use /dev/v1/orders when you need product line items and Shoppex fulfillment. If webhook is provided, the response includes webhook_secret once; use it to verify the order:paid callback for this specific payment/invoice after the payment reaches COMPLETED. For gateway=PANDABASE, Shoppex also creates the provider session and returns checkout_url plus session_id so the payment can complete automatically through the Pandabase webhook flow. For merchant crypto providers (OXAPAY, CRYPTOMUS), pass crypto_gateway to return a hosted checkout URL that opens the concrete coin or network directly. White-label crypto checkout uses Shoppex managed infrastructure, is available by manual approval only, and returns raw crypto payment data for approved shops. White-label responses expose gateway: "WHITE_LABEL" outward while Shoppex keeps the internal processor mapping private.

POST /dev/v1/payments

Create payment

cURL

curl --request POST \
  --url https://api.shoppex.io/dev/v1/payments \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "Pandabase Payment",
  "email": "[e-mail]",
  "value": 24.99,
  "currency": "USD",
  "gateway": "PANDABASE",
  "return_url": "https://app.example.com/payments/success",
  "cancel_url": "https://app.example.com/payments/cancelled",
  "webhook": "https://app.example.com/webhooks/payments",
  "white_label": false
}
'

201

{
  "data": {
    "uniqid": "33333333-3333-4333-8333-333333333333",
    "url": "https://checkout.shoppex.io/invoice/33333333-3333-4333-8333-333333333333",
    "url_branded": "https://pay.example.com/invoice/33333333-3333-4333-8333-333333333333",
    "checkout_url": "https://secure.pandabase.io/pay/stores/store_1/sids/pb_session_3",
    "session_id": "pb_session_3",
    "total": 24.99,
    "currency": "USD",
    "status": "PENDING",
    "created_at": 1711510800
  }
}

Authorizations

Authorization · string · header · required

Use your Shoppex API key in the Authorization header.

Body

application/jsonmultipart/form-datatext/plain

title · string · required

Required string length: 1 - 128

email · string<email> · required

value · number · required

Required range: x >= 0.01

currency · string · required

Required string length: 3

quantity · number

Required range: x >= 1

gateway · string

crypto_gateway · string

cryptoGateway · string

gateways · string[]

confirmations · number

Required range: x >= 1

webhook · string

return_url · string

cancel_url · string

white_label · boolean

custom_fields · object[]

customer_id · string

fraud_shield · object

Show child attributes

Response

201

application/json

Successful response

data · object · required

Option 1

Option 2

Show child attributes