เริ่มต้นการใช้งาน

ขั้นตอนที่ 1: สมัครใช้งานและเข้าสู่ระบบ

เริ่มต้นโดยการสมัครใช้งานโดยการลงทะเบียน โดยสามารถทำตามขั้นตอนดังนี้

  1. คลิกที่ "สมัครสมาชิก" บนหน้าแรกของพอร์ทัล API จากนั้นกรอกข้อมูลที่จำเป็นสำหรับการลงทะเบียน ตั้งรหัสผ่านของคุณ หลังจากการยืนยันและสร้างบัญชีผู้ใช้ใหม่ของคุณ คุณจะได้รับอีเมลสำหรับการยืนยันRegister

     

  2. เมื่อผู้ใช้งานกำหนดแล้ว ระบบจะแสดงหน้าแรกของ API Portal อัตโนมัติ และผู้ใช้สามารถใช้งาน API PortalRegistration successful

 

 

ขั้นตอนที่ 2 : สร้าง App เพื่อใช้ทดสอบ API

 การสร้าง App เป็นขั้นตอนเริ่มต้นสำหรับการเข้าใช้งาน Sandbox API โดยแต่ละ Account จะสามารถสร้าง App ได้มากที่สุด คือ 3 App โดยแต่ละ App จะได้รับ API key และ secret เพื่อใช้ในการทดสอบ

  1. คลิกที่ username ที่มุมขวาของหน้าจอ จากนั้นคลิกที่เมนู ‘My Apps’ จะแสดงหน้า Application Management คลิกที่ปุ่ม ‘สร้าง App’ เพื่อสร้าง App ใหม่
Click username
  1. ระบุข้อมูลสำหรับสร้าง App จากนั้นคลิก ‘บันทึก’
Create app
  1. เมื่อสร้าง App สำเร็จ หน้าจอจะแสดงรายการ App และ ผู้ใช้จะได้รับ Consumer ID , Secret โดยสามารถใช้เพื่อใช้งานทดสอบ APIs SandboxApplication

ขั้นตอนที่ 3: การตรวจสอบความถูกต้อง

1. ชื่อผู้ใช้ (Consumer Key) และรหัสผ่าน (Consumer Secret) ถูกป้อนต่อเนื่องกัน โดยมีเครื่องหมายโคลนเดียว (:) อยู่ระหว่าง

Authen1Authen2

2. ผลลัพธ์สตริงจะถูกเข้ารหัส (Base64) ชุดอักขระควรเป็น UTF-8

3. ตามวิธีการอนุญาตเบื้องต้น ใส่ "Basic" ด้านหน้า ตามด้วยข้อความที่ถูกเข้ารหัสจากรายการด้านบน

curl --request POST 'https://api-sandbox.bangkokbank.com/oauth/accesstoken' \
--header 'Authorization: Basic 
QkF6V29tNGxLa3VVTjdNVVYxTFlPR2hyMllkS0ZoUVc6R01idmJScVRYN3NrT1FWVQ==' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'scope=READ CREATE' \
--data-urlencode 'grant_type=client_c

 

คู่มือการสร้างลายเซ็นดิจิทัล - คู่มือ JWT

API ของธนาคารกรุงเทพใช้ข้อมูลการชำระเงินอย่างปลอดภัยโดยใช้มาตรฐาน JSON Web Token (JWT) (RFC 7519) และ JWT สามารถตรวจสอบโดยใช้ลายเซ็นดิจิทัลที่สร้างขึ้นด้วยคีย์สาธารณะ/ส่วนตัว (RSA256)

  1. คู่มือสร้างโทเคน JWT เพื่อสร้าง JSON Web Token (JWT), คู่ค้าจำเป็นต้องใช้คีย์ลับและข้อมูลคำขอ และจะต้องใช้อัลกอริทึมลายเซ็น RSA256 เพื่อสร้างโทเคน คู่ค้าสามารถใช้ไลบรารี JWT.IO ขึ้นอยู่กับภาษาโปรแกรมที่แอปพลิเคชันของคุณใช้ เพื่อวัตถุประสงค์ที่ Sandbox, คุณสามารถใช้คีย์ต่อไปนี้เพื่อสร้างลายเซ็นดิจิทัลตามคู่มือด้านล่างนี้ ก่อนที่คุณจะสามารถสร้างลายเซ็น JWT, คุณจะต้องรับข้อมูลประจำการใช้ API ตามคู่มือด้านบน เพื่อสร้างลายเซ็น JWT, พอร์ทัลนักพัฒนาของเราจัดให้คุณสามารถใช้งาน API โดยใช้โปรแกรมช่วยในการสร้างลายเซ็น JWT ตามข้อมูลที่คุณใช้สำหรับการเรียก API:

    สร้างคำขอ POST ไปยัง /v1/jwt/partner ของเรา นี่คือตัวอย่างคำขอ:

POST /v1/jwt/partner HTTP/1.1
Host: api-sandbox.bangkokbank.com
Content-Type: application/json
Authorization: <Your oAuth Token>

{
    "serviceCode": "BBLSANDBOX",
    "billerId": "010755000023800",
    "reference1": "1124579998",
    "reference2": "78897",
    "totalAmount": 250.20,
    "shopImage": "UE5HDQoaCgAAAA1JSERSAAAAGAAAABgIBAAAAEp+cwAAAARnQU1BAAALYQUAAAAgY0hSTQAAeiYAAAAAAAAAAAB1MAAAYAAAOgAAF3BRPAAAAAJiS0dEAAAjMgAAAAlwSFlzAAAOAAAOASsOGwAAAAd0SU1FBwQTBTAHAAABPklEQVQ4L0xbURQPDShUEzJDMhQTAGokEwVDJkkwWzIzRUItMDEgOGpqNmAwZitZdxARXmsaSHNzXjoKcU9GcEcmQiUqQghiKS8DKlZcFjo2bAhtCVk/WxIVKypCb0I4N2kJUnxwUiRYEHERahwIQit0fUUGD3VrYUcITWkQLGsKbWpXPl81TDFsL01lVRNAQQsORksaGHMvPDBPHUh2XXt3AWEjCgAAACV0RVh0ZGF0ZTpjcmVhdGUAMjAxOS0wNC0xOVQwMzo0ODowNyswMjowMBZ8AAAAJXRFWHRkYXRlOm1vZGlmeQAyMDE5LTA0LTE5VDAzOjQ4OjA3KzAyOjAwZ3EAAAAZdEVYdFNvZnR3YXJlAHd3dy5pbmtzY2FwZS5vcmc8GgAAAABJRU5EQmA=",
    "shopName": "Sandbox SHOP",
    "osPlatform": "ANDROID",
    "currencyCode": "THB",
    "shippingFee": 30.20,
    "buyerName": "Sandbox Buyer",
    "promotionCode": "BBLSAVE10",
    "additionalInfo": [{
        "name": "string",
        "value": "string"
    }],
    "partnerAppUrl": "com.shop.mobilepartnersandbox://payment",
    "transType": "APP2APP"
}

โปรดระบุ <Your API Token> ด้วย API Token ของคุณที่จริงที่คุณได้รับจากข้อมูลใบรับรองของแอปพลิเคชันของคุณ ส่วนร่างคำขอมีข้อมูลภารกิจที่คุณต้องการสร้างลายเซ็น JWT โดยปรับแต่งภารกิจตามคำขอของคุณ หลังจากคำขอ API สำเร็จ คุณจะได้รับการตอบกลับที่มีลายเซ็น JWT ที่สร้างขึ้น ใช้ลายเซ็น JWT นี้ในส่วนหัวหรือกลไกการอนุมัติที่เหมาะสมสำหรับคำขอ API ต่อไปในแพลตฟอร์มของเรา ลายเซ็น JWT ทำหน้าที่เป็นหลักฐานของการอนุมัติและการอนุญาต

การถอดรหัสและตรวจสอบ JWT

เพื่อถอดรหัส JWT ให้วางลง . JWT.IO จะถอดรหัสโทเคนโดยอัตโนมัติและแสดงหัวข้อและข้อมูลภารกิจ

เพื่อตรวจสอบ JWT ให้ป้อนคีย์ลับที่ใช้ในการลายเซ็น JWT ลงในกล่อง 'VERIFY SIGNATURE' หากลายเซ็นถูกต้อง คุณจะเห็นข้อความ 'Signature Verified' หากลายเซ็นไม่ถูกต้อง หรือถ้าข้อความถูกเปลี่ยนแปลง คุณจะเห็นข้อความ 'Invalid Signature'

หมายเหตุ: เพื่อเหตุผลด้านความปลอดภัยJWT.IO ไม่จำจุดคีย์ลับที่คุณป้อนในเว็บไซต์

การใช้ API Explorer

1. ทำการเรียกใช้ API ใน API Explorer

หลังจากที่ได้รับโทเค็นและสร้างลายเซ็นเจนเรียบร้อยแล้ว คุณสามารถลองใช้ผลิตภัณฑ์ API ในสภาพแวดล้อมที่เข้าถึงได้เสรี

api1

 

api2

2. ทำการเรียกใช้ด้วย Postman Collections

คุณยังสามารถเลือกดาวน์โหลด Postman Collections และทดสอบสถานการณ์ที่ถูกครอบคลุมใน sandbox

Test API via Postman

You can also choose to download the Postman collections and test out the APIs covered in the sandbox from each of API product on the developer portal or via the link below

 

App To App APIs Download Collection                 
Thai QR APIs Download Collection                 

 

How to Import Postman Collections
 
Step 1:
  • Open Postman: Launch the Postman application.
  • Click on the 'Import' button at the top left of the Postman window.
  • In the import dialog, select the downloaded collection file or drag and drop it into the dialog box.
  • Click on 'Import' to add the collection to your Postman workspace.
     
  • Importing collection
 
Step 2:
  • In the "Import File" modal, click on the "Choose Files" button and select the Postman collection file you downloaded from our developer portal to import.
     Select

     

Step 3: Enjoy testing
  • Select a Request: From the imported collection, select the API request you want to test.
  • Configure-Request: If needed, modify the request parameters, headers, or body to suit your test case.
  • Send Request: Click the 'Send' button to execute the request.
  • View Response: Observe the response returned by the API in the lower section of the Postman window.Collections

     

Go-Live

ก่อนที่คุณจะสามารถส่งคำขอ Go-Live, โปรดตรวจสอบให้แน่ใจว่าคุณเข้าใจ API ของธนาคารและวิธีการทำงานของ API ซึ่งเป็นการอ่านคู่มือ API ที่ควรให้รายละเอียดเกี่ยวกับ API รูปแบบของ request/response format (เช่น OAuth หรือ JWT) error codes, rate limiting และอื่น ๆ เริ่มการพัฒนาแอปพลิเคชันด้วยการรวมและทดสอบเวอร์ชัน Sandbox ของ API ในด้านของคุณ**

1. ลงทะเบียนข้อมูลบริษัท

Register