Verify

V3
post /insurance/screening/v3/verify

This endpoint to pre screening process

Download Postman Collection

Request Header
Name Type Required Description
authorization string Required Bearer token
content-type string Required application/json
Request Body
Name Type Required Description
trans_no string Required Unique string that the client can create to track the current request call.

Min length: 10

Max length: 30

mode string Required Screening mode.
  • Full
  • Lite
sale_channel_code string Required Sales channel code to collect transactions.
  • BKO : Broker Online
  • DRO : Direct
  • CNN : AXAConnect
  • INT : Internal
selling_method_code string Conditional Method to sell the insurance policy, which affects to the version of policy wording.
  • F2F : Face to face
  • Online : Online

Condition: This field is required when mode is "Full"

business_type string Conditional Business type
  • Health
  • Marine
  • Motor
  • Property
  • Travel
  • Personal Accident
  • Other

Condition: This field is required when mode is "Full"

product_name string Optional Product name e.g. Smart Thailand Traveller
package_name string Optional Package name e.g. Worldwide
client_type_code string Required Client Type
  • C : Corporate
  • P : Personal
title_name string Conditional Title name.

Max length: 30

Condition: This field is required when client_type_code is "P"

first_name string Conditional First name.

Max length: 200

Condition: This field is required when client_type_code is "P"

last_name string Conditional Last name.

Max length: 200

Condition: This field is required when client_type_code is "P"

company_name string Conditional

Max length: 1000

Condition: This field is required when client_type_code is "C"
date_of_birth date Conditional Date of birth e.g. 1985-09-27

Format: yyyy-mm-dd

Condition: This field is required when client_type is "P" and mode is "Full"

identification_no string Required An identity document (also called ID or colloquially as papers) is any document that may be used to prove a person's identity
gender_code string Conditional Type of gender
  • M : Male
  • F : Female
  • Z : Unknow

Condition: This field is required when client_type is "P" and mode is "Full"

nationality_code string Conditional Nationality code (Based on ISO 3166)

Refer to Master Nationality

Condition: This field is required when client_type is "P" and mode is "Full"

address string Conditional full name e.g. WONOSALAM 06/09 SUKORHARJO SLEMAN DIY 55581

Max length: 250

Condition: This field is required when mode is "Full"

residence_country_code string Conditional Country Code of the Address of the customer. (Based on ISO 3166)

Refer to Master Country

Condition: This field is required when mode is "Full" and client_type_code is "P"

tax_residence_country_code string Conditional Country Code of the Country of Tax Residence. (Based on ISO 3166)

Refer to Master Country

Condition: This field is required when mode is "Full" and client_type_code is "P"

incorporation_country_code string Conditional Country Code where the company has been registered. (Based on ISO 3166)

Refer to Master Country

Condition: This field is required when mode is "Full" and client_type_code is "C"

operation_country_code string Conditional Country Code of the country where the corporate entity has operations. (Based on ISO 3166)

Refer to Master Country

Condition: This field is required when mode is "Full" and client_type_code is "C"

reg_no string Optional Registration Plate e.g. วฐ 9999 กท

Format: aa 9999 xx

Format: aa 999 xx

Format: 1aa 9999 xx

xx : Registration plate (province)

call_back object Optional Callback URL is an address that a partner provides for AXA to POST back data
transaction_by guid Required Globally unique identifier value of the user id Provided by AXA
Example request
{
  "trans_no": "SCN:24:000001",
  "mode":"full",
  "sale_channel_code": "BKO",
  "selling_method_code": "Online",
  "business_type": "Travel",
  "product_name": "Smart Traveller",
  "package_name": "Plan 1",
  "client_type_code": "P",
  "title_name": "",
  "first_name": "Fake",
  "last_name": "Four",
  "date_of_birth": "2024-01-23",
  "identification_no": "0000000000001",
  "gender_code": "M",
  "nationality_code": "THA",
  "address": "222/333 abcd",
  "residence_country_code": "THA",
  "tax_residence_country_code": "THA",
  "reg_no": "",
  "call_back": "",
  "transaction_by": "8c890cb2-9fad-4953-bcc7-e54b9ace827c"
}
Response
Name Type Description
trans_no string Unique string the client made the request
status string Verify status
  • Pass : Can do any transactions
  • Reject : Any transaction is prohibited
  • Seek Approval : In process of approval Do not take any action until approval is obtained.
message string
  • ท่านไม่เข้าเงื่อนไขการรับประกันภัยของบริษัท
  • The customer does not comply with the condition in the underwriting guideline.

Condition:Only use text in the message field when the status "reject" is obtained.

Example response
{
    "trans_no": "SCN:24:000001",
    "status": "Reject",
    "message": "The customer does not comply with the condition in the underwriting guideline."
}