อะไรคือ CardTypeId และ TokenTypeId ในคำขอคำสั่งซื้อบัตร?

ประเภทบัตร หมายถึง การจำแนกประเภทของบัตรเชลล์ตามการใช้งานที่ตั้งใจไว้ ขอบเขตการเข้าถึง และความสามารถในการใช้ตามภูมิภาค

มันกำหนดพารามิเตอร์การดำเนินงานของบัตร CardTypeId คือ ตัวระบุตัวเลขของประเภทบัตร

TokenType เป็นพารามิเตอร์ที่เลือกได้ระหว่างการสั่งซื้อบัตร

ประเภทโทเค็นกำหนดภาพการ์ดและวิธีการส่งการ์ดที่จะใช้กับการ์ดที่สั่งใหม่

เมื่อมีการระบุ CardTypeId และ TokenTypeId ในระหว่างการสั่งการ์ด การรวมกันของ CardTypeId และ TokenTypeId ต้องมีอยู่ในระบบ Shell

หมวดหมู่การใช้งาน:

ยานพาหนะ:สำหรับยานพาหนะในกองรถ (รถยนต์เชิงพาณิชย์ขนาดเล็ก, รถยนต์นั่งส่วนบุคคล, รถยนต์บริการ); ขีดจำกัดการทำธุรกรรมที่ต่ำกว่า, ความถี่การทำธุรกรรมที่สูงกว่า.
Commercial Road Transport(รถบรรทุกหนัก, รถขนส่งทางไกล): ประเภทบัตรเหล่านี้จะมีขีดจำกัดการทำธุรกรรมที่สูงกว่าเป็นค่าเริ่มต้น.

ขอบเขตการยอมรับ:
เดี่ยว : ใช้ได้เฉพาะที่สถานี Shell เท่านั้น
หลาย : ใช้ได้ที่สถานี Shell และสถานที่พันธมิตร
ไฮบริด: - บัตรใช้ได้บน Shell Recharge และสถานที่โรมมิ่ง

ขอบเขตทางภูมิศาสตร์:
ระดับประเทศ: ใช้ได้เฉพาะในประเทศที่ออกบัตรเท่านั้น
นานาชาติ: สามารถใช้ได้ในหลายประเทศ

การกำหนดประเภทบัตร

เมื่อลูกค้าลงนามในข้อตกลงบัตรเชลล์ เชลล์จะสร้างบัญชีบัตรสำหรับลูกค้า
เป็นส่วนหนึ่งของการตั้งค่าบัญชี เชลล์จะกำหนด ประเภทบัตรที่อนุญาต ตามข้อตกลง
สิ่งเหล่านี้กำหนดประเภทของบัตรที่ลูกค้าสามารถสั่งซื้อได้

CardType ต้องเป็น:

• เปิดใช้งานและกำหนดค่าในระดับบัญชีบัตรแล้ว

• CardTypeId ที่ระบุในคำขอสั่งซื้อบัตร ยังไม่ได้ตั้งค่าในบัญชี

คำขอจะได้รับการยอมรับและจะส่งคืนข้อผิดพลาดในการเรียก /card-management/v1/ordercardenquiry -

 { "AccountId": 12, "AccountNumber": "DE00000012",
            "BCOReference": null, "BCORowNumber": null, "CardGroupId": null, "CardGroupName": null, "CardId": null, "CardPAN": null, "CardTypeCode": null,
            "CardTypeId": 206, "CardTypeName": null, "DriverName": null, "ErrorCode": "12011", "ErrorDescription": "การตรวจสอบคำขอการ์ดล้มเหลวสำหรับพารามิเตอร์ที่ป้อน - [CardTypeId ไม่ถูกต้อง.]",
            "GatewaySyncErrorCode": null, "GatewaySyncErrorDescription": null, "GatewaySyncStatus": null, "MainReference": 715047, "OrderCardReference": 947113,
            "OrderStatus": "X", "PayerId": 12, "PayerNumber": "DE00000012", "ProcessedDate": "20250826 13:12:52",
            "รหัสหมวดหมู่การซื้อ": null, "รหัสหมวดหมู่การซื้อ": 124, "ชื่อหมวดหมู่การซื้อ": null, "วันที่ส่ง": "20250826 15:11:50",
            "SyncProcessedDate": null, "SyncRequestedDate": null, "VRN": null, "OrderRequestId": "233e4567-1313-12d3-a456-426614174000",
            "ExpiryDate": null, "ClientReferenceId": null, "StatusDescription": "ล้มเหลว" }

{
    "RequestId": "233e4567-1313-12d3-a456-426614174000", "Status": "FAILED", "Errors": [ {
            "รหัส": "E0001", "ชื่อ": "ข้อผิดพลาดในการตรวจสอบความถูกต้อง", "รายละเอียด": "ไม่มี / ค่าไม่ถูกต้องสำหรับ: [CardDetails[0]]", "ข้อมูลเพิ่มเติม": {
                "CardTypeId": "ไม่ถูกต้อง | ช่วง (1,2147483647)" } } ] }

เพื่อรับ CardTypeIds ที่มีอยู่ในบัญชี ให้เรียกใช้ /customer-management/v1/cardtype endpoint.