POST /qr/generate

Generate PromptPay and merchant QR codes for receiving payments.

Endpoint

POST /qr/generate

Full URL: https://developer.easyslip.com/api/v1/qr/generate

v1 Only

QR code generation is only available in API v1.

Authentication

Required. See Authentication Guide.

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Request

QR Types

Type	Description
PROMPTPAY	Personal PromptPay QR code
KSHOP	Kasikorn K-Shop merchant QR code
MAE_MANEE	Mae Manee merchant QR code
TUNGNGERN	Tungngern merchant QR code

Type Definitions

// Request Types
type QRGenerateRequest =
  | PromptPayRequest
  | KShopRequest
  | MaeManeeRequest
  | TungngernRequest;

interface PromptPayRequest {
  type: 'PROMPTPAY';
  msisdn?: string;       // Mobile number (0xxxxxxxxx)
  natId?: string;        // National ID (13 digits)
  eWalletId?: string;    // E-wallet ID (15 digits)
  amount?: number;       // Amount (max 2 decimals)
}

interface KShopRequest {
  type: 'KSHOP';
  ref1: string;          // Reference 1 (1-20 alphanumeric, uppercase)
  amount?: number;
}

interface MaeManeeRequest {
  type: 'MAE_MANEE';
  ref1: string;          // Reference 1 (1-20 alphanumeric, uppercase)
  amount?: number;
}

interface TungngernRequest {
  type: 'TUNGNGERN';
  ref1: string;          // Reference 1 (1-20 alphanumeric, uppercase)
  merchantName?: string; // Merchant name (1-25 characters)
  amount?: number;
}

// Response
interface QRGenerateResponse {
  status: 200;
  data: QRData;
}

interface QRData {
  image: string;         // Base64-encoded PNG image
  mime: string;          // MIME type (image/png)
  payload: string;       // QR code payload string
}

// Error Response
interface ErrorResponse {
  status: number;
  message: string;
  data?: {
    errors: Array<{ field: string; message: string }>;
  };
}

Examples

PromptPay

cURL

curl -X POST https://developer.easyslip.com/api/v1/qr/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "PROMPTPAY",
    "msisdn": "0812345678",
    "amount": 100.00
  }'

JavaScript

const generateQR = async (config) => {
  const response = await fetch('https://developer.easyslip.com/api/v1/qr/generate', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify(config)
  });

  const result = await response.json();

  if (result.status !== 200) {
    throw new Error(result.message);
  }

  return result.data;
};

// Generate PromptPay QR
const qr = await generateQR({
  type: 'PROMPTPAY',
  msisdn: '0812345678',
  amount: 100.00
});

// Display QR code
const img = document.createElement('img');
img.src = `data:${qr.mime};base64,${qr.image}`;
document.body.appendChild(img);

PHP

function generateQR(array $config): array
{
    $apiKey = getenv('EASYSLIP_API_KEY');

    $ch = curl_init();
    curl_setopt_array($ch, [
        CURLOPT_URL => 'https://developer.easyslip.com/api/v1/qr/generate',
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_POST => true,
        CURLOPT_HTTPHEADER => [
            'Authorization: Bearer ' . $apiKey,
            'Content-Type: application/json'
        ],
        CURLOPT_POSTFIELDS => json_encode($config)
    ]);

    $response = curl_exec($ch);
    curl_close($ch);

    $result = json_decode($response, true);

    if ($result['status'] !== 200) {
        throw new Exception($result['message']);
    }

    return $result['data'];
}

// Generate PromptPay QR
$qr = generateQR([
    'type' => 'PROMPTPAY',
    'msisdn' => '0812345678',
    'amount' => 100.00
]);

// Save as file
$imageData = base64_decode($qr['image']);
file_put_contents('qr-code.png', $imageData);

// Or display inline
echo '<img src="data:' . $qr['mime'] . ';base64,' . $qr['image'] . '">';

Python

import requests
import base64
import os

def generate_qr(config: dict) -> dict:
    response = requests.post(
        'https://developer.easyslip.com/api/v1/qr/generate',
        headers={
            'Authorization': f'Bearer {os.environ["EASYSLIP_API_KEY"]}',
            'Content-Type': 'application/json'
        },
        json=config
    )

    result = response.json()

    if result['status'] != 200:
        raise Exception(result['message'])

    return result['data']

# Generate PromptPay QR
qr = generate_qr({
    'type': 'PROMPTPAY',
    'msisdn': '0812345678',
    'amount': 100.00
})

# Save as file
image_data = base64.b64decode(qr['image'])
with open('qr-code.png', 'wb') as f:
    f.write(image_data)

print(f"Payload: {qr['payload']}")

K-Shop

{
  "type": "KSHOP",
  "ref1": "ORDER12345",
  "amount": 250.00
}

Mae Manee

{
  "type": "MAE_MANEE",
  "ref1": "ORDER12345",
  "amount": 500.00
}

Tungngern

{
  "type": "TUNGNGERN",
  "ref1": "ORDER12345",
  "merchantName": "MY STORE",
  "amount": 750.00
}

Response

Success (200)

{
  "status": 200,
  "data": {
    "image": "iVBORw0KGgoAAAANSUhEUgAA...",
    "mime": "image/png",
    "payload": "00020101021230..."
  }
}

Response Fields

Field	Type	Description
image	string	Base64-encoded PNG image
mime	string	MIME type (image/png)
payload	string	QR code payload string

Error Responses

Invalid Request (400)

{
  "status": 400,
  "message": "invalid_request",
  "data": {
    "errors": [
      { "field": "ref1", "message": "Required" }
    ]
  }
}

Unauthorized (401)

{
  "status": 401,
  "message": "unauthorized"
}

Parameter Reference

PromptPay

Parameter	Type	Required	Description
type	string	Yes	"PROMPTPAY"
msisdn	string	One of	Mobile number (0xxxxxxxxx)
natId	string	One of	National ID (13 digits)
eWalletId	string	One of	E-wallet ID (15 digits)
amount	number	No	Amount (max 2 decimals)

TIP

You must provide exactly one of: msisdn, natId, or eWalletId.

K-Shop

Parameter	Type	Required	Description
type	string	Yes	"KSHOP"
ref1	string	Yes	Reference 1 (1-20 alphanumeric, uppercase)
amount	number	No	Amount (max 2 decimals)

Mae Manee

Parameter	Type	Required	Description
type	string	Yes	"MAE_MANEE"
ref1	string	Yes	Reference 1 (1-20 alphanumeric, uppercase)
amount	number	No	Amount (max 2 decimals)

Tungngern

Parameter	Type	Required	Description
type	string	Yes	"TUNGNGERN"
ref1	string	Yes	Reference 1 (1-20 alphanumeric, uppercase)
merchantName	string	No	Merchant name (1-25 characters)
amount	number	No	Amount (max 2 decimals)

Notes

• QR code generation does not consume verification quota
• Generated QR codes are valid indefinitely
• Amount is optional - customer can enter amount when paying
• Reference fields must be alphanumeric and uppercase