Skip to main content
POST
/
payments
/
v2
/
intent
Create payment intent
curl --request POST \
  --url https://sandbox-api.sandbox.lemmax.com/payments/v2/intent \
  --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"
}
'
{
  "data": {
    "error_code": "ERR06",
    "flow": "PAYMENT",
    "notes": [],
    "payment_intent_id": "0f7660c1-a106-481f-acf9-1848e98a7230",
    "widget_data": "eyJhY2Nlc3NfdG9rZW4iOiJleUpoYkdjaU9pSklVekkxTmlJc0luUjVjQ0k2SWtwWFZDSjkuZXlKaGNIQmZhV1FpT2lKbE9EWTRZakJqTnkwMU5tUm1MVFF4WlRRdFlUWmxOQzAyT0RKbU9USTJNR1UzWTJJaUxDSmpkWE4wYjIxbGNsOXBaQ0k2SWpVMFltVTFZemRqTFRFMU1tUXROR1poWmkwNE5UWXpMVE5sT0Rkak1HSXlPV00wTWlJc0ltVnRZV2xzWDJGa1pISmxjM01pT2lKMFpYTjBhVzVuUUc1dmNuUm9aWEp1YkdGaWN5NWpZU0lzSW1WdFlXbHNYM1psY21sbWFXVmtJanBtWVd4elpTd2laWGh3SWpveE5qa3lNRFExTVRJNUxDSnBjM01pT2lKbWIzSjBaVjloZFhSb1gzTjJZeUlzSW0xbGNtTm9ZVzUwWDJsa0lqb2lNMlZqTWpjM01XRXRabVV4WmkwME5HVTVMV0ZqWXpVdE9XRm1NV0U1T1dWbVpHWXhJaXdpZEc5clpXNWZkSGx3WlNJNkltVjRkR1Z5Ym1Gc1gzUnZhMlZ1SW4wLnFSNHJ2ZUx6NUVBS3V4T3VxMU5LQmFDSS0zaGgwVVFVaUxCak1oLVZPZDAiLCJpdGVtIjp7ImFtb3VudCI6IjEwMC4wMCIsImN1cnJlbmN5IjoiVVNEIiwiZGVzYyI6IlN0YXJ0ZXIgU2V0IEEiLCJmZWUiOiJDT1ZFUkVEIiwiaWQiOiIxMjM0NTY3OCIsImltYWdlX3VybCI6Imh0dHBzOi8vd3d3LmdhbWVzLmNvbS8xQS5wbmciLCJ0aXRsZSI6IkVhcmx5IEFjY2VzcyBQcmVzYWxlIFNlcmllcyAxQSIsInRvdGFsIjoiMTAwLjAwIiwidHlwZSI6IkJVWV9XRUIyIn0sInBheW1lbnRfaW50ZW50X2lkIjoiMzVmZGRmOTUtZDZhZC00YTVmLWJhZjktODE5ZWU2MDI2M2Q0IiwicGF5bWVudF9tZXRob2RzIjpbeyJlbmFibGVkIjp0cnVlLCJpZCI6ImNhMDFlMjM1LTA1ODItNDdmMC04NzcxLTgwNjNiYWEwMmYxMSIsIm1ldGFkYXRhIjpudWxsLCJtZXRob2QiOiJjcnlwdG8iLCJwcm92aWRlciI6ImNvaW5iYXNlIn0seyJlbmFibGVkIjp0cnVlLCJpZCI6ImM1ZDhiZDE1LWI5OTItNDljMy1hMjdjLWViNjcyZWVmZTUxYSIsIm1ldGFkYXRhIjp7IkFwaVB1YmxpY0tleSI6InBrX3Nib3hfcWltZ2EycTV0MnV5cmNvM2JibmhteHlnMmljIn0sIm1ldGhvZCI6ImNyZWRpdCIsInByb3ZpZGVyIjoiY2hlY2tvdXQifV0sInNlbmRfdG8iOiJQTEFJIEFjY291bnQiLCJ0cmFuc2FjdGlvbl90eXBlIjoiQlVZX1ZEQSJ9"
  }
}

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

Response

Create Payment Intent Response

Create Payment Intent Response Schema

​
data
object
required