Create Payment | Pay API Reference

POST /api/pay/create_payment.php

Requires Authorization: AppID:AppKey + user token

Request body

Field	Type	Required	Default	Description
token	string	required	—	User session token
itemKey	string	required	—	Product key from the console
quantity	int	optional	1	Number of items
currency	string	optional	"usd"	`usd`, `brl`, or `eur`
success_url	string	optional	Vanelton default	Redirect URL after successful payment
cancel_url	string	optional	Vanelton default	Redirect URL if user cancels
debug	bool	optional	false	Use Stripe test mode

Test this endpoint

Headers

Authorization *

Body

token *

itemKey *

currency

success_url

cancel_url

Success response 200

{
  "success": true,
  "message": "Payment link created successfully.",
  "payment_url": "https://checkout.stripe.com/pay/cs_live_..."
}

{
  "success": true,
  "message": "Item granted for free via Vanelton Pass.",
  "free_via_pass": true
}

If itemKey is an in-app purchase the publisher marked as Vanelton Pass-eligible, and the buyer has an active Pass, the item is granted for free and no checkout session is created — the response has no payment_url. Always check free_via_pass before assuming payment_url exists. This only applies to items the publisher opted in — most purchases go through the standard flow even for Pass subscribers.

Errors

Code	Message
401	Invalid or expired token.
400	itemKey not found or not active.