Thanh toán App to App

Giới thiệu dịch vụ

Loại hình dịch vụ App to App là giải pháp thanh toán áp dụng cho đối tác có ứng dụng di dộng (Android/iOS) muốn hỗ trợ thanh toán trực tiếp qua ứng dụng VinID.

Khách hàng mua hàng trên ứng dụng của đối tác và chọn VinID Pay là phương thức thanh toán. Hệ thống sẽ tự động kết nối với ví VinID Pay và tiến hành thanh toán cho giao dịch của khách hàng.

Quá trình thanh toán sẽ diễn ra liên tục mà khách hàng không cần phải tự mở nhiều ứng dụng cùng lúc.

Sơ đồ luồng trải nghiệm người dùng

Sequence diagram

Luồng xử lý hệ thống

APIs

Create Order

POST {API-HOST}/merchant-integration/v1/qr/create-transaction-order

API to create new order

Request Body

Name	Type	Description
extra_data	string	Thông tin thêm cho đơn hàng
order_reference_id	string	Mã đơn hàng của đối tác. Sử dụng để refund và đối soát.
order_currency	string	Mã tiền tệ ( VND )
store_code	string	Mã cửa hàng
description	string	Thông tin mô tả đơn hàng
callback_url	string	Callback URL của đối tác
pos_code	string	Mã POS
order_amount	number	Số tiền thanh toán
service_type	string	Giá trị mặc định = PURCHASE
user_id	string	User ID của đối tác

200

{
    "meta": {
        "code": 200,
        "message": "OK"
    },
    "data": {
        "signature": "",
        "order_id": "20190101T00300000001",
        "expired_at": 0
    }
}

Query Order Status

GET {API-HOST}/merchant-integration/v1/qr/query/{order_id}

API to check current order status

Path Parameters

Name	Type	Description
order_id	string	Order ID

200

{
  "data": {
    "created_at": 0,
    "merchant_user_id": "string",
    "order_amount": 0,
    "order_id": "string",
    "pay_status": "string",
    "point_amount": 0,
    "transaction_id": "string",
    "updated_at": 0,
    "vnd_amount": 0
  },
  "meta": {
    "code": 0,
    "message": "string"
  }
}

Thông tin thêm:

• API Host
• Extra Data
• Request Header
• Callback
• Ví dụ Request / Response

Bảng mã lỗi

Tham khảo Bảng mã lỗi

Mobile SDK

iOS	Android
iOS Mobile SDK	Android Mobile SDK