Tích hợp API

Đăng ký merchant mới

Trước khi một merchant có thể sử dụng SDK, merchant đó phải được đăng ký trong hệ thống Tapaya. Việc này thường được thực hiện khi người dùng đăng ký sử dụng dịch vụ của bạn. Bạn chỉ cần đăng ký merchant một lần. Có thể đăng ký trong Tapaya Platform UI hoặc qua API.

Endpoint: POST /merchant/auth/register

curl -X 'POST' 'https://api.tapaya.com/merchant/auth/register' \
-H 'Content-Type: application/json' \
-H 'Authorization: REPLACE_ME' \
-d '{
        "merchantToken": "unique_merchant_id_from_your_db",
        "merchantName": "Acme Corp",
        "email": "admin@acme.com"
    }'

Tham số:

Phản hồi:

Nội dung phản hồi:

{
    "merchantToken": "unique_merchant_id_from_your_db"
}

Tạo token đăng nhập

Để một thiết bị di động có thể khởi tạo SDK cho một merchant cụ thể, bạn phải tạo một token đăng nhập ngắn hạn. Ứng dụng di động của bạn sẽ yêu cầu token này từ backend của bạn, và backend sẽ yêu cầu nó từ Tapaya. Bạn cần một token mới mỗi lần SDK được khởi tạo.

Endpoint: POST /merchant/auth/login

curl -X 'POST' 'https://api.tapaya.com/merchant/auth/login' \
-H 'Content-Type: application/json' \
-H 'Authorization: REPLACE_ME' \
-d '{
        "merchantToken": "unique_merchant_id_from_your_db",
        "allowOnboarding": true,
        "employeeEmail": "john@acme.com"
    }'

Tham số:

Phản hồi:

Nội dung phản hồi:

{
    "token": "EesrFq4PUK1WxHUj93hkrKASDFp8GxJ0"
}

Chuyển token này cho ứng dụng di động của bạn để khởi tạo SDK. Hãy truyền token tới ứng dụng di động một cách bảo mật và xóa nó ngay sau khi sử dụng. Token được gắn với merchant được xác định bởi merchantToken.