Immediate tokenized payment charge (auth + capture)

post

https://integrations-sandbox.shopback.com/demo/merchant/tokenized-payment/v1/charge

Charges the user's linked payment method in a single step without a pre-authorization hold. Use this for one-shot payments where you do not need to adjust the amount before capture.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

paymentToken

string

required

Payment token from POST /token. Resolves the user and their default card.

merchantUserId

string

required

Merchant's opaque identifier for the end user. Must match the merchantUserId used when the paymentToken was issued.

amount

number

required

Charge amount. Must be > 0.

currency

string

required

3-letter ISO currency code. Must match the merchant channel country currency.

merchantRef

string

required

Merchant's reference ID. Used for idempotent duplicate detection.

useCashback

boolean

Defaults to true

Whether to apply available cashback to this charge.

callbackUrl

string

HTTPS URL to receive order status webhook notifications. When provided, ShopBack will POST the order outcome to this URL upon payment completion or failure. Must use HTTPS with a valid public domain.

Headers

X-ShopBack-Idempotent-Id

string

required

Unique key to safely retry the request without duplicate charges. Use a UUID per logical charge attempt.

Responses

201

400One or more required fields are missing, the amount must be greater than zero, or the currency is invalid.

401The payment token was not found, has been unlinked, or belongs to a different merchant.