Skip to main content
POST
/
payments
/
v2
/
intent
/
redirect
Create intent for widget redirect
curl --request POST \
  --url https://sandbox-api.sandbox.lemmax.com/payments/v2/intent/redirect \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "buyer": {
    "email": "example@email.com",
    "id": "unique_customer_id"
  },
  "currency": "USD",
  "idempotency_key": "unique_string",
  "items": [
    {
      "amount": "10.70",
      "description": "optional item description",
      "id": "item id",
      "image_url": "https://developer-image.url/image.png",
      "title": "Item title"
    }
  ],
  "transaction_type": "BUY_VDA",
  "reference": "44cda1bb-2625-4acf-9d84-0cb78589e9a6"
}
'
{
  "data": {
    "redirect_url": "https://redirect.forte.io/0f7660c1-a106-481f-acf9-1848e98a7230?redirect_token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdGF0ZSI6IjRnd1ZRWnFDV0FMYXBHZVVvS0tpQm4zRVIyWkRweDExIiwiZXhwIjoxNjkyMDQ1MTI5LCJpc3MiOiJmb3J0ZV9hdXRoX3N2YyIsInRva2VuX3R5cGUiOiJleHRlcm5hbF90b2tlbiJ9.avRqsX_ohBVaZ-3i1eCUWkqPrJhuTafjklh5BJ4oevQ"
  }
}

Authorizations

​
Authorization
string
header
required

access_token returned by the /auth/v1/oauth2/tokens API call.

Body

application/json

Payment intent request payload

Request payload for BUY_VDA transaction type

​
buyer
object
required

Details of the customer purchasing the item. Either email or wallet or both must be present.

​
currency
enum<string>
required

Currency of the item.

Available options:
USD,
EUR
Example:

"USD"

​
idempotency_key
string
required

A unique value provided to ensure the operation is idempotent.

Maximum string length: 1000
Example:

"idempotency-key-1"

​
items
object[]
required
Required array length: 1 element
​
transaction_type
enum<string>
required

Transaction type for buying Virtual Digital Assets, e.g. game currency.

Available options:
BUY_VDA
​
reference
string

Optional merchant-provided reference.

Maximum string length: 100
Example:

"44cda1bb-2625-4acf-9d84-0cb78589e9a6"

Response

Create intent redirect response

​
data
object
required