Slip Verification

Process and verify payment slip image

POSTSlip Verification

Endpoint URL

https://crmwpayz.trustsig.xyz/api/slip/process

Authentication Status

API Key is required for all requests Webhook Secret

Headers

x-api-key

Required

API Key for authentication

x-signature

Required

HMAC-SHA256 signature for authentication

x-timestamp

Required

Timestamp (milliseconds) for signature

Parameters (Request Body)

uuid

string Required

System ID (UUID)

slipImageUrl

string Required

Slip Image URL

Success Response

Payment Status (success = true)

Only returns true when payment status changes from pending to successful. Returns false for all other cases. Always returns HTTP status 200.

Example:

{
  "success": true,
  "message": "ดำเนินการเรียบร้อย",
  "data": {
    "uuid": "4176fd08-9e9d-4cfd-99ee-67cfa901f5cd",
    "amount": 500.09,
    "transRef": "KMA2508031236370eaTSJBBA2",
    "date": "2025-08-03T12:36:34+07:00"
  }
}

Error Status Codes

List of possible error codes and their meanings

Error Code	Severity	Description
9014, 9008	Warning	Duplicate Payment Verification This payment transaction has already been verified and completed (may be a duplicate slip submission for confirmation)
9025	Error	Missing Time Information The slip does not contain time information or the system cannot read the time from the slip. Please ensure slip has clear date/time information.
9022	Error	Amount Difference Exceeded The amount in the slip differs too much from the payment order amount. Please transfer the exact amount or create a new payment order.
7014, 9035	Error	Duplicate Slip This slip has already been used for another transaction. The system will show which transaction ID used this slip.
9032, 9029	Error	Destination Account Mismatch Customer transferred money to an incorrect account (does not match the account specified in the payment order).
9021, 9020	Error	Source Bank Not Specified This payment order does not specify the source bank that the customer will deposit from, making verification impossible.
9033, 9036, 9037	Error	Customer Account Mismatch Customer used a different bank account than specified in the payment order. The response will show both expected and actual account details.
9002	Error	Order Not Found The Order ID or UUID was not found in the system, or the payment order may have expired.

Request Example

cURL

curl --location 'https://crmwpayz.trustsig.xyz/api/slip/process' \
  --request POST \
  --header 'x-api-key: $SIGNATURE_API_KEY' \
  --header 'x-signature: $SIGNATURE' \
  --header 'x-timestamp: $TIMESTAMP' \
  --header 'Content-Type: application/json' \
  --data '{
    "uuid": "4176fd08-9e9d-4cfd-99ee-67cfa901f5cd",
    "slipImageUrl": "https://example.com/slip-image.jpg"
}'

Response Example

200 OK Response

{
    "success": false,
    "message": "✅ ธุรกรรมการชำระเงินนี้ได้รับการชำระแล้ว",
    "data": {
        "uuid": "4176fd08-9e9d-4cfd-99ee-67cfa901f5cd",
        "amount": 500.09,
        "transRef": "KMA2508031236370eaTSJBBA2",
        "date": "2025-08-03T12:36:34+07:00",
        "errorCode": 9008,
        "slipInfo": {
            "sender": {
                "address": "XXX-1-23378-X",
                "target_type": "BANKAC",
                "bank_code": "025",
                "name": "SOMCHAI J"
            },
            "receiver": {
                "address": "XXXXXXXXX3482",
                "target_type": "NATID",
                "name": "บริษัท ทดสอบ จำกัด",
                "bank_code": "",
                "ref1": "",
                "ref2": "",
                "ref3": ""
            },
            "amount": 500.09,
            "transRef": "KMA2508031236370eaTSJBBA2"
        }
    }
}