Create Payment Intent

Create a payment intent for a specific transaction type.

POST /payments/v2/intent

Create payment intent

cURL

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": "[e-mail]",
    "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"
}
'

201

{
  "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.

Option 1

Option 2

Option 3

Show child attributes

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

Show child attributes

transaction_type · enum<string> · required

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

Available options: BUY_VDA

Response

201

application/json

Create Payment Intent Response

create_payment_intent_kyc_required_response

create_payment_intent_banned_customer_response

create_payment_intent_kyw_failed_response

create_payment_intent_success_response

Create Payment Intent Response Schema

data · object · required

Show child attributes