Create Policy

post /insurance/travel/v3/policies

This endpoint to create policy.

Request Header

Name	Type	Required	Description
authorization	string	Required	Bearer token
content-type	string	Required	application/json

Request Body

Name	Type	Required	Description
lang	string	Required	Policy language en th
trans_no	string	Required	Unique string that the client can create to track the current request call. Min length: 10 Max length: 30
quotation_id	guid	Required	The quotation id is used for issuing the policy
total_premium	decimal(18,2)	Required	Total premium according to quotation
policy_holder	object	Required	Json object containing details of the Policy Holder
travellers	array [object]	Required	Json array object containing details of the Traveller
long_names	array [object]	Required	Json object containing details of the Array
reference1	string	Optional	Reference text Max length: 30
reference2	string	Optional	Reference text Max length: 30
call_back	string	Optional	Callback URL is an address that a partner provides for AXA to POST back policy data
transaction_by	string	Required	Globally unique identifier value of the user id Provided by AXA

Example request

{
    "lang":"EN",
    "trans_no": "BB083044acf0140044",
    "quotation_id": "2f6fcdaa-3107-4e80-7b3c-08d9935205ef",
    "total_premium":  375.02,
    "policy_holder": {
        "client_type": "P",
        "title_code": "042",
        "first_name": "JHEOL",
        "last_name": "KIMMY",
        "birth_date": "1970-05-04",
        "gender": "F",
        "marital_code": "S",
        "card_type": "I",
        "corporate_name1": "",
        "corporate_name2": "",
        "tax_id": "0000000000001",
        "branch": "",
        "address_type": "R",
        "address1": "101 14 SEOBINGGO-RO 91GA-GIL",
        "address2": "YONGSAN-GU SEOUL KOREA",      
        "postal_code": "12000",
        "country_code": "KOR",
        "nationality_code": "KOR",
        "phone_number1": "+822354382",
        "phone_number2": "",
        "phone_number3": "",
        "email": "example@axa.co.th"
    },
    "travellers": [
        {
            "title_code": "042",
            "first_name": "JHEOL",
            "last_name": "KIMMY",
            "birth_date": "1970-05-04",
            "gender": "F",
            "marital_code": "S",
            "card_type": "I",
            "tax_id": "ZM82796231",
            "address_type": "R",
            "address1": "101 14 SEOBINGGO-RO 91GA-GIL",
            "address2": "YONGSAN-GU SEOUL KOREA",            
            "postal_code": "12000",
            "country_code": "KOR",
            "nationality_code": "KOR",
            "phone_number1": "",
            "phone_number2": "",
            "phone_number3": "",
            "email": "example@axa.co.th",
            "domicile": "KOR",
            "occupation_code": "01-1019-01",
            "pre_existing_disease": "",
            "beneficiaries": [
            {
              "line": 1,
              "name": "ESTATE OF THE INSURED PERSON",
              "relation_code": "001",
              "ratio": 100,
              "tel": ""
            }
          ]
        }
    ],
    "long_names": [],
    "call_back":"",
    "reference1":"",
    "reference2":"",
    "transaction_by": "8C890CB2-9FAD-4953-BCC7-E54B9ACE827C"
}

Response

Name	Type	Description
trans_no	string	Unique string the client made the request
status	string	Policy status SeekApproval : seek approval Issued : policy created
message	string
policies	array [object]	Json array object containing details of the Policy

Example response

{
    "trans_no": "BB083044acf0140052",
    "status": "Issued",
    "message": "",
    "policies": [
        {
            "policy_id": "d6fe1816-d847-4563-8a95-38fcb085276c",
            "policy_no": "Q61000001",
            "policy_holder_name": "JHEOL KIMMY",
            "traveller_name": "Traveller 1",
            "reference": "ZM82796231",
            "downloads": [
                {
                    "type": "Schedule",
                    "layer": "Original",
                    "link": "https://uatapiconnect.axa.co.th/report/d312af4ae978432596ed1b3931be74c8"
                    
                },
                {
                    "type": "Taxinvoice",
                    "layer": "Original",
                    "link": "https://uatapiconnect.axa.co.th/report/d1b756345d6c4dcfb3268ca79d09b3b7"
                },
                {
                    "type": "Certificate",
                    "layer": "Original",
                    "link": "https://uatapiconnect.axa.co.th/report/3a89d7e3e51d4a8f8f43d67ad8f7c3d5"
                },
                {
                    "type": "Schedule",
                    "layer": "Copy",
                    "link": "https://uatapiconnect.axa.co.th/report/b89742e607cd4763ab5f571ddb843078"
                },
                {
                    "type": "Taxinvoice",
                    "layer": "Copy",
                    "link": "https://uatapiconnect.axa.co.th/report/3a89d7e3e51d4a8f8f43d67ad8f7c3d5"
                }
            ],
            "links": [
                {
                    "href": "https://uatapiconnect.axa.co.th/insurance/travel/v1/policies/d6fe1816-d847-4563-8a95-38fcb085276c/cancel?hash=Oi7xpnY7BGRdJyCiC9WIaoFRDkndM165",
                    "rel": "cancel_policy",
                    "method": "PUT"
                }
            ]
        }
    ]
}

Policy Reference

Name	Type	Description
policy_id	guid	Policy id
policy_no	string	Policy number
policy_holder_name	string	Refer to policy holder by request
traveller_name	string	Refer to traveller by request
reference	string	Refer to traveller passport/citizen id by request
downloads	array [object]	Json array object containing details of the Download
links	array [object]	Json array object containing details of the Link

Download Reference

Name	Type	Description
type	string	Type of download Schedule Taxinvoice Certificate
layer	string	Type of layer Original Copy
link	string	Hyperlink points to a whole document

Link Reference

Name	Type	Description
method	string	HTTP method e.g. GET, PUT, POST
rel	string	Used to describe the action of a link e.g. cancel_policy
href	string	Endpoint to take action

Array Reference

Name	Type	Required	Description
line	int	Required	Sequence number
text	string	Required	Text is anything that conveys a set of meanings

Policy Holder Reference

Name	Type	Required	Description
client_type	string	Required	Client Type C : Corporate P : Personal
title_code	string	Conditional	Title code `Condition:` This field is required when "Client Type" is "P" Refer to Master Title
first_name	string	Conditional	First name Max length: 30 `Condition:` This field is required when "Client Type" is "P"
last_name	string	Conditional	Last name Max length: 30 `Condition:` This field is required when "Client Type" is "P"
birth_date	date	Required	Date of birth e.g. 1985-09-27 Format: yyyy-mm-dd `Condition:` The policy holder is at least 6 months old but not over 100 years old.
gender	string	Required	Type of gender M : Male F : Female Z : Unknow
marital_code	string	Required	Marital status S : Single M : Married W : Widowed D : Divorced
card_type	string	Required	Card Type I : Citizen ID P : Passport Number G : Government `Condition:` - This field must be "G" when client_type is "C" - This field must be "I" or "P" when client_type is "P"
corporate_name1	string	Conditional	Max length: 60 `Condition:` This field is required when client_type is "C"
corporate_name2	string	Optional	Max length: 60
tax_id	string	Required	Max length: 20 `Condition:` This field should be "Citizen ID" value when card_type is "I" and "Passport Number" value when card_type is "P"
branch	string	Conditional	Branch name of customer company Max length: 30 Note: If there is no branch, specify สำนักงานใหญ่ or Head Office `Condition:` This field is required when client_type is "C"
address_type	string	Required	Address Type B : Office R : Home P : Postal
address1	string	Required	Address/Street Max length: 30
address2	string	Optional	Max length: 30
postal_code	string	Required	Postal code e.g. 12000 Refer to Master Postal code
country_code	string	Required	Country code (Based on ISO 3166) Refer to Master Country
nationality_code	string	Required	Nationality code (Based on ISO 3166) Refer to Master Nationality
phone_number1	string	Optional
phone_number2	string	Optional
phone_number3	string	Optional
email	string	Optional	Email address

Traveller Reference

Name	Type	Required	Description
title_code	string	Conditional	Title code Refer to Master Title
first_name	string	Conditional	First name Max length: 30
last_name	string	Conditional	Last name Max length: 30
birth_date	date	Required	Date of birth e.g. 1985-09-27 Format: yyyy-mm-dd `Condition:` The age of the traveller depends on the insurance conditions.
gender	string	Required	Type of gender M : Male F : Female Z : Unknow
marital_code	string	Required	Marital status S : Single M : Married W : Widowed D : Divorced
card_type	string	Required	Card Type I : Citizen ID P : Passport Number
tax_id	string	Required	Max length: 20 `Condition:` This field should be "Citizen ID" value when card_type is "I" and "Passport Number" value when card_type is "P"
address_type	string	Required	Address Type B : Office R : Home P : Postal
address1	string	Required	Address Max length: 30
address2	string	Optional	Max length: 30
postal_code	string	Required	Postal code e.g. 12000 Refer to Master Postal code
country_code	string	Required	Country code (Based on ISO 3166) Refer to Master Country
nationality_code	string	Required	Nationality code (Based on ISO 3166) Refer to Master Nationality
phone_number1	string	Optional
phone_number2	string	Optional
phone_number3	string	Optional
email	string	Optional	Email address
domicile	string	Required	Country code (Based on ISO 3166) Refer to Master Country
pre_existing_disease	string	Optional	Pre-existing disease
occupation_code	string	Optional	a job or profession. Refer to Master Occupation
beneficiaries	array[object]	Optional	Json array object containing details of the Beneficiary

Beneficiary Reference

Name	Type	Required	Description
line	int	Required	Sequence number
name	string	Required	Beneficiary person's name Max length: 50
relation_code	string	Required	A person who is connected by blood or marriage; a kinsman or kinswoman. Refer to Master Relation
ratio	int	Required	Beneficiary Ratio `Condition:` The sum of all beneficiaries' ratios must be 100.
tel	string	Optional

V3

Request Header

Request Body

Example request

Response

Example response

Policy Reference

Download Reference

Link Reference

Array Reference

Policy Holder Reference

Traveller Reference

Beneficiary Reference