What is Dokmai Angpao API?

Dokmai Angpao is a REST API that lets developers claim TrueWallet vouchers programmatically with authentication and request logging.

How do I claim a TrueWallet voucher via API?

Send a request with the voucher URL to the claim endpoint. The API validates the input, processes the claim, and returns the result with logs.

v1.0Last updated: Mar 2026

Claim TrueWallet Vouchers With One API Call.

Full API reference for claiming TrueWallet vouchers. Auth, retries, error codes, and examples included.

Your Angpao Claim Engine.

Dokmai Angpao API processes TrueWallet voucher claims through one secure endpoint with authentication, idempotency, and traceable request IDs.

Base URL

https://api.dokmaistore.com

Authentication

Production requests support either:

x-dokmai-api-key: <your_api_key>
Authorization: Bearer <buyer_jwt>

If both are provided, API key authentication is evaluated first.

Main Endpoint

POST`/api/v1/angpao/redeem`

Claims a voucher using a Thai phone number and voucher input.

Required Headers

Content-Type: application/json
x-dokmai-api-key: your_api_key_here
Idempotency-Key: claim-20260306-001

Idempotency-Key Rules

Strongly recommended for production.
Length: 8-128 characters.
Allowed charset: [A-Za-z0-9._:-].
Same caller + same key returns a cached result for safe retries.

Request Body

{
  "phoneNumber": "0900000000",
  "voucher": "https://gift.truemoney.com/campaign/?v=abc123..."
}

Voucher Field Aliases

Send at least one voucher field:

voucher
voucherCode
voucherUrl
link

Field Validation

Field	Type	Required	Validation
`phoneNumber`	String	Yes	Thai format `0xxxxxxxxx`
`voucher`	String	Yes*	Voucher URL or code
`voucherCode`	String	Yes*	Alias of `voucher`
`voucherUrl`	String	Yes*	Alias of `voucher`
`link`	String	Yes*	Alias of `voucher`

* One voucher field is required.

Response Format

Success (200)

{
  "success": true,
  "data": {
    "source": "dokmai_angpao",
    "provider": "truewallet",
    "amount": 88,
    "currency": "THB",
    "voucherId": "641f0e2e31b9f8xxxx",
    "detail": "Voucher redemption",
    "ownerName": "Gift Sender",
    "redeemerPhoneMasked": "090-***-0000",
    "redemptionDate": "2026-03-06T09:10:11.000Z",
    "expireDate": "2026-03-10T12:00:00.000Z",
    "providerCode": "SUCCESS"
  },
  "requestId": "89e7b18a-dad3-4eca-beb2-d8a4f0d8d8fa"
}

Error (Non-2xx)

{
  "success": false,
  "error": {
    "code": "angpao_not_found",
    "message": "Voucher not found",
    "retryable": false,
    "requestId": "89e7b18a-dad3-4eca-beb2-d8a4f0d8d8fa",
    "details": {
      "providerCode": "VOUCHER_NOT_FOUND"
    }
  }
}

Error Codes

Code	HTTP	Retryable	Meaning
`unauthorized`	401	No	Missing or invalid API key/JWT
`forbidden`	403	No	Authenticated identity is not allowed
`forbidden_service_scope`	403	No	API key scope is not allowed
`invalid_api_key`	401	No	API key is invalid or inactive
`rate_limited`	429	Yes	Caller exceeded RPM
`invalid_json`	400	No	Invalid JSON body
`invalid_body`	422	No	Body is not a JSON object
`missing_required_fields`	422	No	Missing `phoneNumber` or voucher field
`invalid_phone_number`	400	No	Invalid Thai phone format
`invalid_voucher_code`	400	No	Voucher link/code is invalid
`invalid_idempotency_key`	422	No	Idempotency key format is invalid
`unsupported_content_type`	415	No	Must send `application/json`
`angpao_not_found`	404	No	Voucher not found
`angpao_already_redeemed`	409	No	Voucher already redeemed/out of stock
`angpao_expired`	410	No	Voucher expired
`angpao_recipient_mismatch`	422	No	Cannot claim your own voucher
`angpao_redeem_failed`	422	No	Provider rejected the claim
`provider_rate_limited`	429	Yes	Upstream provider throttled
`provider_unavailable`	503	Yes	Upstream provider unavailable
`provider_invalid_payload`	502	Yes	Upstream returned invalid payload
`storage_unavailable`	503	Yes	Database/storage unavailable
`internal_error`	500	No	Unexpected internal failure

Rate Limit Headers

Every response includes:

X-RateLimit-Limit: 120
X-RateLimit-Remaining: 119
X-RateLimit-Reset: 1760000000
X-Request-Id: 89e7b18a-dad3-4eca-beb2-d8a4f0d8d8fa

Throttled responses include:

Retry-After: 30

Quick Start (cURL)

curl -X POST "https://api.dokmaistore.com/api/v1/angpao/redeem" \
  -H "Content-Type: application/json" \
  -H "x-dokmai-api-key: YOUR_API_KEY" \
  -H "Idempotency-Key: claim-20260306-001" \
  -d '{
    "phoneNumber": "0900000000",
    "voucher": "https://gift.truemoney.com/campaign/?v=YOUR_CODE"
  }'

Quick Start (Node.js)

const response = await fetch('https://api.dokmaistore.com/api/v1/angpao/redeem', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-dokmai-api-key': process.env.DOKMAI_API_KEY,
    'Idempotency-Key': `claim-${Date.now()}`,
  },
  body: JSON.stringify({
    phoneNumber: '0900000000',
    voucher: 'https://gift.truemoney.com/campaign/?v=YOUR_CODE',
  }),
});

const payload = await response.json();

if (payload.success) {
  console.log('Claimed amount:', payload.data.amount);
} else {
  console.error(payload.error.code, payload.error.message, payload.error.requestId);
}

Web Form Endpoint (No-Auth UI Proxy)

POST`/api/dokmaiservice/v1/angpao/redeem`

This endpoint powers the claim form at angpao.dokmai.app.

No API key or JWT required.
Requires phoneNumber and voucher.
Protected by per-IP rate limits.
Internally forwards to POST https://api.dokmaistore.com/api/v1/angpao/redeem using server-side credentials.
Uses the same core API pipeline, so request tracking and usage logs are centralized.
Not intended for backend automation.

Operational Guidance

Persist requestId in logs for support and reconciliation.
Retry only when retryable: true.
Validate phone and voucher inputs before every request.