Beladed Payments guide
Accept a payment safely
BusinessStreamerserverweb
Create a customer-facing payment link without handling raw card data.
Prerequisites
- An eligible merchant account
- A development secret key stored only on the server
- A return URL on an allowed application domain
Implementation
- 1
Create the customer on your server
Send customer identity data from a trusted backend and keep the returned customer identifier.
- 2
Create the payment link
Send the amount in minor units, currency, merchant identifier, and customer-safe description.
- 3
Redirect to hosted checkout
Open the returned checkout URL. Do not collect or forward a card number or verification code.
- 4
Confirm asynchronously
Verify webhook signatures and reconcile the transaction with a server-side read.
Related API operations
POST
/api/payment/customer/create
Create CustomerCreate Customer through the reviewed Beladed Payments contract.
POST
/api/payment/link/create
Create Payment LinkCreate Payment Link through the reviewed Beladed Payments contract.
POST
/api/payment/transaction/get
Transaction - GetTransaction - Get through the reviewed Beladed Payments contract.
Production checklist
- Use production credentials only with api.beladed.com.
- Keep secret credentials on a trusted server.
- Verify account ownership, permissions, origins, and webhook signatures.
- Handle idempotency, timeouts, retries, and duplicate events.
- Log request IDs without logging credentials or sensitive payloads.