Getting Started

Get up and running with Altafinex QR code payments in minutes. This guide will walk you through account setup, API key generation, and generating your first QR code.

1

Account Setup

Sign up for an Altafinex account to get started. You'll receive access to both test and production environments.

What You'll Get
  • Merchant dashboard access
  • Test API keys for development
  • Production API keys (after approval)
  • Access to documentation and support
2

Get Your API Keys

API keys are used to authenticate your requests. You'll find them in your merchant dashboard under Settings → API Keys.

Test Keys
Use test keys for development and testing. Test payments won't charge real money.
pk_test_...
Production Keys
Production keys are available after account approval. Use these for live transactions.
pk_live_...

Security Best Practice:

Never expose your Secret Key (sk_...) in client-side code. Always use it on your backend server only.

3

Make Your First API Call

Let's generate a test QR code to verify your integration is working correctly.

Example: Generate QR Code
Replace YOUR_SECRET_KEY with your actual secret key
curl https://api.altafinex.com/v1/qr-codes \
  -X POST \
  -H "Authorization: Bearer YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 10000,
    "currency": "THB",
    "reference": "ORDER-12345",
    "client_name": "John Doe",
    "client_bank_name": "Bangkok Bank",
    "client_bank_account": "1234567890",
    "metadata": {
      "client_id": "CLIENT-12345"
    }
  }'

Note:

This will generate a QR code that you can display to customers. When they scan it with their PromptPay-enabled banking app, the payment will be processed automatically. Learn more about QR codes.

4

Testing QR Codes

Use our test environment to generate QR codes and test the payment flow without processing real payments.

Test QR Codes
Test Mode:

In test mode, QR codes are generated but payments won't be processed through real banks. You can simulate payment completion via the dashboard.

QR Code Expiry:

Test QR codes expire after 15 minutes by default. You can adjust this when generating QR codes.

Payment Simulation:

Use the merchant dashboard to simulate successful or failed payments for testing webhooks.

5

Going Live Checklist

Before processing real payments, ensure you've completed these steps:

Pre-Launch Checklist

  • Account Approval

    Complete KYC verification and get production access

  • Webhook Configuration

    Set up webhooks to receive payment notifications

  • Error Handling

    Implement proper error handling for all API calls

  • Idempotency Keys

    Use idempotency keys to prevent duplicate charges

  • Security Review

    Ensure API keys are stored securely and never exposed

Next Steps

Tokenization
Learn how to securely tokenize card data
Webhooks
Set up webhooks for real-time notifications
Security
Understand security best practices