Verify Bank Slip By Payload

Send a qr code payload for verification

• URL: /verify
• Method: GET
• Headers:
  • Authorization: Bearer YOUR_ACCESS_TOKEN
• Query Parameters:
  • payload (string, required): Data read from qr code

Request Example

curl --location 'https://developer.easyslip.com/api/v1/verify?payload=PAYLOAD' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN'

Response Type

type Data = {
    status: number
    data: {
        payload: string
        transRef: string
        date: string
        countryCode: string
        amount: {
            amount: number
            local: {
                amount?: number
                currency?: string
            }
        }
        fee?: number
        ref1?: string
        ref2?: string
        ref3?: string
        sender: {
            bank: {
                id: string
                name?: string
                short?: string
            }
            account: {
                name: {
                    th?: string
                    en?: string
                }
                bank?: {
                    type: 'BANKAC' | 'TOKEN' | 'DUMMY'
                    account: string
                }
                proxy?: {
                    type: 'NATID' | 'MSISDN' | 'EWALLETID' | 'EMAIL' | 'BILLERID'
                    account: string
                }
            }
        }
        receiver: {
            bank: {
                id: string
                name?: string
                short?: string
            }
            account: {
                name: {
                    th?: string
                    en?: string
                }
                bank?: {
                    type: 'BANKAC' | 'TOKEN' | 'DUMMY'
                    account: string
                }
                proxy?: {
                    type: 'NATID' | 'MSISDN' | 'EWALLETID' | 'EMAIL' | 'BILLERID'
                    account: string
                }
            }
            merchantId?: string
        }
    }
}

Response Example

Success (HTTP 200)

{
  "status": 200,
  "data": {
    "payload": "00000000000000000000000000000000000000000000000000000000000",
    "transRef": "68370160657749I376388B35",
    "date": "2023-01-01T00:00:00+07:00",
    "countryCode": "TH",
    "amount": {
      "amount": 1000,
      "local": {
        "amount": 0,
        "currency": ""
      }
    },
    "fee": 0,
    "ref1": "",
    "ref2": "",
    "ref3": "",
    "sender": {
      "bank": {
        "id": "001",
        "name": "กสิกรไทย",
        "short": "KBANK"
      },
      "account": {
        "name": {
          "th": "นาย อีซี่ สลิป",
          "en": "MR. EASY SLIP"
        },
        "bank": {
          "type": "BANKAC",
          "account": "1234xxxx5678"
        }
      }
    },
    "receiver": {
      "bank": {
        "id": "030",
        "name": "ธนาคารออมสิน",
        "short": "GSB"
      },
      "account": {
        "name": {
          "th": "นาย อีซี่ สลิป"
        },
        "bank": {
          "type": "BANKAC",
          "account": "12xxxx3456"
        },
        "proxy": {
          "type": "EWALLETID",
          "account": "123xxxxxxxx4567"
        }
      }
    }
  }
}

Error (HTTP 400)

invalid_payload

{
  "status": 400,
  "message": "invalid_payload"
}

Error (HTTP 401)

unauthorized

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

Error (HTTP 403)

access_denied

{
  "status": 403,
  "message": "access_denied"
}

account_not_verified

{
  "status": 403,
  "message": "account_not_verified"
}

application_expired

{
  "status": 403,
  "message": "application_expired"
}

application_deactivated

{
  "status": 403,
  "message": "application_deactivated"
}

quota_exceeded

{
  "status": 403,
  "message": "quota_exceeded"
}

Error (HTTP 404)

slip_not_found

{
  "status": 404,
  "message": "slip_not_found"
}

Error (HTTP 500)

server_error

{
  "status": 500,
  "message": "server_error"
}

api_server_error

{
  "status": 500,
  "message": "api_server_error"
}