Create hosted checkout session
Create a public SideShift-hosted checkout link for your embed-enabled SideShift account.
Redirect any payer to data.url. The hosted page matches SideShift’s invoice payment UI and renders a SideShift checkout. When payment succeeds, the net amount is credited to your SideShift wallet and deposit.confirmed is emitted with metadata.source = "connect_hosted_checkout".
To embed checkout inside your own app, create the session from your backend with your SideShift API key, then render data.embedUrl (or data.widgetUrl) in an iframe. Do not expose your API key in browser code.
The embedded checkout posts a sideshift.checkout.completed message to the parent window after SideShift verifies payment.
Authorizations
Your SideShift Connect API key (sk_live_* or sk_test_*). Generate from Settings → Connect.
Body
Net amount to credit to the wallet, in cents
x >= 1005000
Optional destination override. Defaults to the API-key company's own SideShift wallet. If supplied, the account must belong to or be linked to your Connect integration.
"acct_a1b2c3d4e5f6"
Checkout description shown to the payer
"Premium creator bundle"
Optional payer email to prefill in checkout. The payer can still edit it.
Optional payer name for your own reconciliation
Optional URL to redirect to after SideShift verifies payment
Optional URL for the hosted page cancel link
Payment method used for fee calculation. Defaults to card.
card, link, apple_pay, google_pay, amazon_pay, cashapp, paypal, venmo, crypto, coinbase, us_bank_account, us_bank_transfer, eu_bank_transfer, gb_bank_transfer, au_bank_transfer, pay_by_bank, klarna, affirm, afterpay_clearpay "card"
Optional payment methods to restrict the hosted checkout to. Omit this field to use SideShift's default checkout methods.
card, link, apple_pay, google_pay, amazon_pay, cashapp, paypal, venmo, crypto, coinbase, us_bank_account, us_bank_transfer, eu_bank_transfer, gb_bank_transfer, au_bank_transfer, pay_by_bank, klarna, affirm, afterpay_clearpay Up to 50 key/value pairs returned in deposit webhooks