Payments

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. Native BTC/LTC uses the shop’s non-custodial wallet when crypto_gateway=BITCOIN|LITECOIN is requested and a native wallet is active; send gateway=NATIVE_CRYPTO to require that path and fail if it is not configured. Shoppex-managed white-label crypto is deprecated for new integrations; use Native Crypto for BTC/LTC or connect OxaPay/Cryptomus.

POST

dev

payments

Create payment

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": "[email protected]",
  "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
}
'

{
  "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

title

string

required

Required string length: 1 - 128

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[]

customFields

object[]

product_id

string

productId

string

items

object[]

cart

string

products

object[]

customer_id

string

fraud_shield

object

Show child attributes

Response

Successful response

data

object

required

Option 1
Option 2

Show child attributes

Create checkout sessionStripe-style alias for `POST /dev/v1/payments`. Accepts `amount`, `success_url`, `cancel_url`, `customer_email`, and a single `product` descriptor; returns a session shape with `id`, `url`, and `status`. Internally delegates to the payments endpoint, so PSP orchestration, idempotency, scopes, and webhook behavior are identical. For multi-item checkouts, build the cart on your side and call this endpoint with the aggregated amount.

Create payment

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": "[email protected]",
  "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
}
'

{
  "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
  }
}