Finansia Portal

# DOPA

Objective: API for verify user's citizen ID card status with DOPA service

Mock logic:

```

check mock: first_name == mockFirstName && last_name == mockLastName

check status: national_id == mockPID && date_of_birth == mockDOB && laser_code == mockLaser

```

API:

 - Method: POST

 - Endpoint: https://dopa-api.acecoin.com/api/v1/check-by-laser

Paylod:

|key|type|value|

|:--|:--|:--|

|national_id|string|ID card number|

|first_name|string|firstname|

|last_name|string|lastname|

|date_of_birth|string|yyyyMMdd|

|laser_code|string|laser code|

Return:

|key|type|value|

|:--|:--|:--|

|success|bool||

|message|string|"success", "failed", "Invalid request body"|

|data|Object|DOPA Object \| Internal Error Object|

---

DOPA Object

|key|type|value|mandatory|

|:--|:--|:--|:--|

|code|string||Y|

|desc|string|card status message|Y|

|isNormal|bool|card stauts, true= normal, false= abnormal|Y|

|recomendation|string|recommend message|Y|

---

Internal Error Object

|key|type|value|mandatory|

|:--|:--|:--|:--|

|code|string||Y|

|message|string|invalid message by internal check|Y|

---

Exmaple Request and Response:

Expected Mock Payload:

```

{

  "national_id": "6400719122941",

  "first_name": "ทดสอบ",

  "last_name": "บัตร",

  "date_of_birth": "25430101",

  "laser_code": "AB0123456789"

}

```

Expected Return when Card Status is Normal:

```

{

    "success": true,

    "message": "success",

    "data": {

        "code": 0,

        "desc": "สถานะปกติ",

        "isNormal": true,

        "recommendation": "normal"

    }

}

```

Expected Return when Card Status is Abnormal:

```

{

    "success": true,

    "message": "failed",

    "data": {

        "code": 2,

        "desc": "บัตรสถานะไม่ปกติ",

        "isNormal": false,

        "recommendation": "contact_registry"

    }

}

```

Expected Return when national_id format is invalid by internal check:

```

{

    "success": false,

    "message": "Invalid request body",

    "error": {

        "code": "23100",

        "message": "field is invalid: PID with request_id: f408c4e2-4296-4f84-b05d-d7fe51961b01"

    }

}

```

attachment: [Internal] DESC-CheckCardBank(New) 11-10-65.pdf

attachment: [Internal] Final Checkcardststus.pdf

attachment: [Internal] Final Checkcardststus.pdf

attachment: Funtion GetCID.txt

attachment: POST.txt

attachment: กรุณาอ่านก่อนครับ.txt

attachment: Dopa-test.postman_collection.json