Ví điện tử VinID Pay

Ví điện từ VinID Pay là giải pháp giúp khách hàng không phải lo lắng quản lý giao dịch chi tiêu hay mang theo quá nhiều tiền mặt theo người mà vẫn có thể tự do mua sắm, thanh toán hóa đơn, dịch vụ một cách nhanh chóng và an toàn, mọi lúc mọi nơi.

Trở thành đối tác của Ví điện tử VinID Pay là cơ hội để tăng doanh thu của bạn với tập khách hàng trung thành và tiềm năng của VinID cũng như hệ sinh thái Vingroup.

Lợi ích cho doanh nghiệp khi tích hợp dịch vụ thanh toán VinID Pay

Khách hàng của bạn được gì ?

Các hình thức tích hợp dịch vụ thanh toán VinID Pay

VinID cung cấp cho các đối tác 2 môi trường để tích hợp vào hệ thống bao gồm :

• UAT: Sử dụng trong quá trình tích hợp bao gồm xây dựng tính năng, kiểm thử, debug, v.v..

• Production: Sử dụng để triển khai cho người dùng cuối có thể sử dụng dịch vụ.

API Host

Địa chỉ host server cho các API

• UAT: https://api-merchant-uat.vinid.dev/{api_path}

• Production: https://api-merchant.vinid.net/{api_path}

Merchant Website

Là trang web dành riêng cho đối tác phục vụ việc tra cứu giao dịch và quản lý các thông tin kết nối (keycode, store, pos, ...).

Bên cạnh đó VinID cũng cung cấp ứng dụng dành cho đối tác trên mobile (Android/iOS) với các chức năng tương tự trên Merchant Website.

Xem thêm:

Mobile App

VinID là ứng dụng trợ lý thông minh của công ty OneID thuộc tập đoàn One Mount Group.

Ứng dụng VinID chạy trên 2 nền tảng Android và iOS, kết nối tất cả các mảng trong hệ sinh thái rộng lớn của tập đoàn Vingroup.

VinID sở hữu mạng lưới đối tác doanh nghiệp hàng đầu. Khách hành có thể sở hữu nhiều ưu đãi hấp dẫn từ mạng lưới đối tác từ hàng ngàn thương hiệu được yêu thích nhất.

Với nguồn dữ liệu đa dạng, VinID nhận diện và thấu hiểu chân dung khách hàng mục tiêu của đối tác, từ đó cung cấp các giải pháp nhân hoá phù hợp với từng cá nhân trên ứng dụng VinID.

Ứng dụng VinID tích hợp nhiều tính năng hữu ích giúp cho cuộc sống của người sử dụng trở nên dễ dàng hơn, thuận tiện hơn.

• Voucher - sở hữu mã ưu đãi từ hàng trăm đối tác uy tín

• Shopping qua các tính năng Đi chợ / Mua sắm / Ăn uống

• Tính năng Mua vé với các sự kiện thể thao, giải trí nổi bật

• Giải pháp thanh toán tiện lợi, an toàn thông qua Ví điện từ VinID Pay

• Tích và tiêu điểm VinID khi thanh toán hóa đơn tại Vinmec / Vinmart / Vinpearl ... và hàng ngàn điểm chấp nhận thanh toán khác.

VinID sở hữu tập khách hàng tiềm năng lớn với dữ liệu hành vi phong phú với gần 10 triệu khách hàng thân thiết của tập đoàn VinGroup.

Nền tảng công nghệ đáng tin cậy, kiến trúc linh hoạt, cho phép phát triển các tính năng phức tạp trong thời gian ngắn.

Bước 1: Đăng nhập vào Merchant Site bằng tài khoản do VinID cung cấp.

Bước 2: Tìm đến phần API Key trong mục Tích hợp thanh toán.

Bước 3: Bấm vào nút TẠO MỚI và nhập các thông tin cần thiết.

• Tên Key : để phân biệt các X-Key-Code trong danh sách

• Ngày hết hạn : nếu không chỉ định thì X-Key-Code sẽ có hạn sử dụng là vĩnh viễn.

• Tự Động Tạo Key : mặc định hệ thống sẽ tự động sinh ra Public key và cấp Private key tương ứng cho merchant. Trường hợp merchant muốn sử dụng Public key của mình thì có thể bỏ check ở option này và điền Public key của mình vào ô Public key ở bên phải.

Bước 4: Bấm nút XÁC NHẬN để thực hiện tạo X-Key-Code

Nếu ở Bước 3, merchant sử dụng tính năng Tự động tạo key thì hệ thống sẽ trả lại Private key tương ứng. Vui lòng lưu giữ Private key này để thực hiện việc tạo signature trong các API request gửi đến với X-Key-Code mà bạn vừa tạo.

Ví dụ minh họa với hình thức thanh toán Transaction QR

Request

Response

VinID sử dụng chữ ký điện tử (signature) để xác thực dữ liệu đầu vào và ra trên mỗi HTTP Request.

Hệ thống VinID sử dụng thuật toán SHA256 RSA ( key size = 2048 bit) để tạo signature.

Tạo chữ ký điện tử

Format chữ ký điện tử

• PrivateKey: do merchant tự generate ra theo định dạng SHA256 RSA ( 2048 )

• URL: Endpoint API

Ví dụ:

Code mẫu tạo Signature

Điểm VinID

Điểm VinID hay còn gọi là Vinpoint là điểm được tích lũy từ các giao dịch mua sắm hàng hoá, hoặc dịch vụ tại các địa điểm kinh doanh thuộc Tập đoàn Vingroup.

Điểm VinID có thể được sử dụng để chi tiêu ở rất nhiều nơi trong hệ sinh thái đa dạng của Vingroup mang lại giá trị sử dụng lớn, dễ dàng, tiện lợi cho khách hàng, giúp bạn đơn giản hơn trong các giao dịch thanh toán bởi ngay cả khi không còn tiền trong Ví hoặc quên mang theo tiền mặt, bạn vẫn có thể mua hàng và thanh toán thành công.

1 điểm Vinpoint được quy đổi giá trị tương đương 1.000 đồng khi thanh toán tại các điểm giao dịch thuộc hệ thống Vingroup, cụ thể như:

• Mua sắm từ xa tại siêu thị ảo VinMart 4.0 bằng tính năng Scan & Go trên ứng dụng VinID

• Mua sắm hàng hoá tại hơn 1500 siêu thị VinMart và các cửa hàng VinMart+

• Đóng học phí tại Vinschool

• Khám bệnh tại Vinmec

• Du lịch, nghỉ dưỡng tại Vinpearl

• Thanh toán phụ tùng, chi phí sửa chữa tại Vinfast

Lợi ích cho doanh nghiệp khi ích hợp dịch vụ Loyalty với VinID Point

Nếu khách hàng trong hệ thống loyalty của bạn đang chờ đợi những sản phẩm quy đổi hấp dẫn hơn bên cạnh thẻ điện thoại, vé xem phim, thì VinID Point chính là điều mà bạn cần. Còn gì tiện lợi hơn cho khách hàng của bạn bằng một đơn vị điểm loyalty với khả năng sử dụng tại hàng ngàn địa điểm trong hệ sinh thái Vingroup trên toàn quốc như VinID Point?

Đối tác có toàn quyền triển khai và quản lý nghiệp vụ loyalty trên hệ thống của mình (về hình thức, cơ chế, tỷ lệ quy đổi ....) và VinID sẽ chỉ tham gia như một nhà cung cấp điểm Vinpoint tới khách hàng theo hình thức mà đối tác yêu cầu. Chỉ cần khách hàng đã sở hữu thẻ thành viên VinID hoặc đăng ký tài khoản trên ứng dụng VinID là có thể sử dụng được Vinpoint với vô vàn tiện ích.

Các hình thức tích hợp dịch vụ loyalty VinID Point

Hiện tại VinID cung cấp Vinpoint cho đối tác tích hợp qua 2 hình thức:

Sử dụng trong trường hợp đối tác muốn bổ sung thêm thông tin cho 01 giao dịch.

Hệ thống VinID sẽ đọc theo format sau:

Ví dụ:

Step 1 - Determined the platform

OneID SSO support many type of platform including:

1. Native/Mobile App (Mobile or Desktop app that support web browser web-view)

2. Single-Page App (JavaScript web app that runs in the browser)

3. Regular Web App (Traditional web app that runs on the server)

4. Backend/API (An API or service protected)

Step 2 - Pick the SDK

Select the SDK that match with your project programing language

Step 3 - Create Client

Contact us to create/register Client: VUPNA@Onemount.com

Tenant & Client is the identity of the 3rd party service which use OneID SSO. Required information for registering including:

1. client_id - ID of the 3rd party app

2. client_secret - optional

3. redirect_uris - the redirect url after the process complete

4. owner - owner of the 3rd party app

5. contacts - email of the owner

6. client_name - name of the 3rd party app. This information is required for white label

7. logo_uri - logo of the 3rd party app. This information is required for white label

8. client_uri - home page URL of 3rd party app. This information is required for white label

9. policy_uri - policy page. This information is required for white label

10. tos_uri - term & condition page. This information is required for white label

11. post_logout_redirect_uri - Hyperlink when click on 3rd party app logo image

12. frontchannel_logout_uri - Logout URL for frontent

13. backchannel_logout_uri - Logout URL for backend

14. metadata - json format data which contain additional data such as:

    1. background image

    2. hotline - phone number

    3. support email

Step 4 - Working Flow

Make the login button.

Assuming step 2 & 3 is completed.

1. User click the login button on 3rd app

2. SDK it will generate code_verifier and code_challenge (from code_verifier).

4. OneID redirect to OneID login form

5. User login and consent scope

6. OneID callback authorization_code to 3rd app

7. SDK call /token endpoint with authorization_code and code_verifier

8. OneID validate code_verifier

9. OneID return access_token, id_token & access_token

Get resource with authorization code

10. 3rd party app uses access_token to access resource server (ex: /userinfo endpoint). 11. Resource server return data.

Các bước cơ bản để tích hợp với VinID

2. Bộ phận hỗ trợ kinh doanh của VinID sẽ tạo và gửi cho đối tác một tài khoản khách hàng thông qua email mà khách hàng cung cấp.

   Đối tác cần hoàn thành quá trình đăng ký với đầy đủ thông tin. Thông tin tích hợp mặc định là môi trường Sandbox.

3. Đối tác sử dụng tài khoản được cung cấp đăng nhập vào Merchant Site do VinID cung cấp để khởi tạo các thông tin cần thiết.

4. Đối tác tiến hành tích hợp theo tài liệu tích hợp kỹ thuật của VinID. Phía VinID sẽ có người support đối tác trong quá trình tích hợp.

5. Sau khi phía đối tác hoàn thành tích hợp và kiểm thử trên môi trường Sandbox, VinID sẽ xác thực dịch vụ của bạn trên môi trường Sandbox trước khi đưa lên môi trường Production.

6. Sau khi tích hợp hoàn thành, VinID sẽ tiến hành nghiệm thu dịch vụ trước khi triển khai Production.

7. VinID cung cấp thông số kỹ thuật trên môi trường production, đối tác tiến hành cấu hình trên hệ thống.

8. Triển khai dịch vụ thanh toán cho khách hàng. VinID và đối tác thỏa thuận các chương trình khuyến mại cho khách hàng (nếu có).

9. Hỗ trợ giải đáp các vấn đề phát sinh (nếu có).

/oauth2/auth

GET https://oauth-qc.vinid.dev/oauth2/auth

API Này sử dụng cho luồng Authorization code (PKCE), sau khi authentication thành công, một authorization code (query parameter) sẽ được redirect về callback endpoint của ứng dụng.

Query Parameters

/oauth2/token

POST https://oauth-qc.vinid.dev/oauth2/token

Request Body

Thời gian hết hạn của refresh_token mặc định là 720 giờ

Để có thể thực hiện tích hợp vào hệ thống VinID, đối tác cần tuân thủ các quy tắc kĩ thuật chung sau :

Mọi request đến hệ thống VinID đều tuân thủ theo Request Header sau :

/oauth2/token

POST https://oauth-qc.vinid.net/oauth2/token

API này được sử dụng cho Authorization code (PKCE) để exchange token từ authorization code có được từ Auth endpoint.

Headers

Request Body

{
  "access_token": "string",
  "expires_in": 0,
  "id_token": 0,
  "refresh_token": "string",
  "scope": 0,
  "token_type": "string"
}

Giới thiệu dịch vụ

Là giải pháp hỗ trợ cho các đơn vị kinh doanh, đối tác thanh toán qua các thiết bị có thể hiển thị mã QR hoá đơn (máy POS/ web/ app/ in hoá đơn…)

Khi khởi tạo hóa đơn, đối tác gửi thông tin đến hệ thống VinID Pay để tạo mã. Khách hàng sử dụng tính năng “Quét mã” trên ứng dụng VinID để quét mã do nhân viên cửa hàng cung cấp và tiến hành thanh toán mà không cần nhập thêm bất cứ thông tin nào.

Để sử dụng Transaction QR, đối tác có thể lựa chọn 1 trong 2 phương án như sau:

• Chủ động tích hợp với hệ thống thanh toán VinID Pay.

• Sử dụng máy POS của các đối tác đã tích hợp thanh toán với VinID Pay như KiotViet, mPOS, iPOS.

Luồng người dùng sử dụng dịch vụ

Trải nghiệm tính năng thanh toán

Sequence diagram

APIs

Generate Transaction QR

POST {API-HOST}/merchant-integration/v1/orders/tqr

New API return generated QR for payment. For old endpoint, please read note below

Request Body

Thông tin thêm:

Thông tin mã lỗi

Code mẫu

/user-management/user-info

GET https://oauth-qc.vinid.dev/user-management/user-info

Headers

Hiện tại VinID Pay đã hỗ trợ các hình thức thanh toán khác nhau, phục vụ cho cả In-store Payment và Online Payment.

In-store Payment/QR Pay

Online Payment

/.well-known/openid-configuration

GET https://oauth-qc.vinid.dev/.well-known/openid-configuration

​Cấu hình tích hợp OneID

{
  issuer: "https://oauth2-dev.vinid.dev/",
  authorization_endpoint: "https://oauth2-dev.vinid.dev/oauth2/auth",
  token_endpoint: "https://oauth2-dev.vinid.dev/oauth2/token",
  jwks_uri: "https://oauth2-dev.vinid.dev/.well-known/jwks.json",
  subject_types_supported: [
    "public"
  ],
  response_types_supported: [
    "code",
    "code id_token",
    "id_token",
    "token id_token",
    "token",
    "token id_token code"
  ],
  claims_supported: [
    "sub"
  ],
  grant_types_supported: [
    "authorization_code",
    "implicit",
    "client_credentials",
    "refresh_token"
  ],
  response_modes_supported: [
    "query",
    "fragment"
  ],
  userinfo_endpoint: "https://oauth2-qc.vinid.dev/user-management/user-info",
  scopes_supported: [
    "offline",
    "openid"
  ],
  token_endpoint_auth_methods_supported: [
    "client_secret_post",
    "client_secret_basic",
    "private_key_jwt",
    "none"
  ],
  userinfo_signing_alg_values_supported: [
    "none",
    "RS256"
  ],
  id_token_signing_alg_values_supported: [
    "RS256"
  ],
  request_parameter_supported: true,
  request_uri_parameter_supported: true,
  require_request_uri_registration: true,
  claims_parameter_supported: false,
  revocation_endpoint: "https://oauth2-dev.vinid.dev/oauth2/revoke",
  backchannel_logout_supported: true,
  backchannel_logout_session_supported: true,
  frontchannel_logout_supported: true,
  frontchannel_logout_session_supported: true,
  end_session_endpoint: "https://oauth2-dev.vinid.dev/oauth2/sessions/logout"
}//20200908143350//https: //oauth2-dev.vinid.dev/.well-known/openid-configuration​{
  "issuer": "https://oauth2-dev.vinid.dev/",
  "authorization_endpoint": "https://oauth2-dev.vinid.dev/oauth2/auth",
  "token_endpoint": "https://oauth2-dev.vinid.dev/oauth2/token",
  "jwks_uri": "https://oauth2-dev.vinid.dev/.well-known/jwks.json",
  "subject_types_supported": [
    "public"
  ],
  "response_types_supported": [
    "code",
    "code id_token",
    "id_token",
    "token id_token",
    "token",
    "token id_token code"
  ],
  "claims_supported": [
    "sub"
  ],
  "grant_types_supported": [
    "authorization_code",
    "implicit",
    "client_credentials",
    "refresh_token"
  ],
  "response_modes_supported": [
    "query",
    "fragment"
  ],
  "userinfo_endpoint": "https://oauth2-qc.vinid.dev/user-management/user-info",
  "scopes_supported": [
    "offline",
    "openid"
  ],
  "token_endpoint_auth_methods_supported": [
    "client_secret_post",
    "client_secret_basic",
    "private_key_jwt",
    "none"
  ],
  "userinfo_signing_alg_values_supported": [
    "none",
    "RS256"
  ],
  "id_token_signing_alg_values_supported": [
    "RS256"

Phía đối tác cần chuẩn bị Callback API để nhận về kết quả giao dịch thành công từ phía VinID Pay. (Với thanh toán thất bại, VinID Pay sẽ không thực hiện callback)

VinID sẽ cung cấp một Public Key cho đối tác để có thể thực hiện xác thực request do VinID gọi qua theo format sau :

Format: status;transactionID;orderID
signature = SHA256WithRSA(status;transactionID;orderID)

Method: GET
Query string:
○ order_id : mã đơn hàng
○ pay_status : trạng thái đơn hàng
○ transaction_id : mã giao dịch bên hệ thống của VinID
○ signature : chữ ký điện tử, để đối tác có thể verify request
Example: 
https://merchant-host.com?extra_data=&order_id=20190178900134567890&pay_status=SUCCESS&point_amount=0&total_discount=0&transaction_id=1234567890&user_id=12345&vnd_amount=99000&signature=sAHaSf1peit3rrMmD2PivrDSWq1dE%2BolCe1rknWH0f%2FV5eYZ5lJv7Kygrv7Wp9PUbZUO2lbbLUBSFfdF7y4UVwQLFIzFTUCBymPqYFyOz8nsTXFWAoneigFm0B4%2BoZIT1yVZERF2mqwnFdPLRhnkCN4zq9z8g%3D%3D

Giới thiệu dịch vụ

Là giải pháp thanh toán tiện lợi cho các đối tác của VinID Pay bằng mã QR định danh cửa hàng (MerchantQR) do VinID Pay cung cấp giúp quản lý dòng tiền và đơn hàng 1 cách rõ ràng và hiệu quả.

Khách hàng chỉ cần thực hiện với 3 bước đơn giản: 1- Dùng tính năng "Quét mã" trên ứng dụng VinID, quét QR cửa hàng (thường đặt ở quầy thu ngân, tại bàn…); 2- Nhập số tiền cần thanh toán. 3- Xác nhận thanh toán bằng ví điện tử VinID Pay.

Hệ thống sẽ tự động cập nhật số dư và chuyển tiền về ví của đối tác. Đối tác được cung cấp công cụ app/web để nhận thông tin giao dịch.

Luồng người dùng sử dụng dịch vụ

Sau khi ký hợp đồng, đơn vị kinh doanh, đối tác sẽ được VinID Pay hỗ trợ toàn diện về kỹ thuật và công nghệ. Đối tác không cần phải kết nối về kỹ thuật. Các bước hợp tác giữa VinID Pay - Đối tác:

Bước 1: Đối tác kí kết hợp đồng hợp tác với VinID Pay.

Bước 2: Đối tác được VinID Pay hỗ trợ tạo mã QR thanh toán và POSM tại cửa hàng.

Bước 3: Đối tác được cung cấp tài khoản và công cụ trên app/web để kiểm tra thông tin số dư và lịch sử giao dịch.

Trải nghiệm tính năng thanh toán

/oauth2/sessions/logout

GET https://oauth-qc.vinid.dev/oauth2/sessions/logout

Query Parameters

post_logout_redirect_uri = urlencode(https://your_redirect_page?state=example)

• frontchannel_logout_uri được sử dụng để OneID hủy token đối với frontend app.

GET https://yourapp.test/frontchannel_logout?iss=https://oauth-dev.vinid.dev/&sid=08a5019c-17e1-4977-8f42-65a12843ea02

• backchannel_logout_uri được sử dụng để OneID hủy token đối với backend app.

POST /backchannel_logout HTTP/1.1
Host: yourapp.test
Content-Type: application/x-www-form-urlencoded

logout_token=eyJhbGci ... .eyJpc3Mi ... .T3BlbklE ...

Giới thiệu dịch vụ

Là giải pháp hỗ trợ các đơn vị kinh doanh, đối tác có sở hữu website.

Khách hàng mua hàng tại website của đối tác, chọn VinID Pay là phương thức thanh toán, hệ thống sẽ điều hướng khách hàng sang cổng thanh toán VinID Pay.

Tại đây, khách hàng có quyền lựa chọn giữa 2 hình thức thanh toán sau:

• Sử dụng tài khoản VinID của khách hàng để đăng nhập trên cổng thanh toán và tiến hành thanh toán mà không cần mở ứng dụng VinID.

• Dùng tính năng quét mã trên ứng dụng VinID để quét mã QR hóa đơn được tạo trên cổng thanh toán để tiến hành thanh toán như các hình thức khác.

Hướng dẫn người dùng sử dụng dịch vụ

Trải nghiệm tính năng thanh toán

Sequence diagram

APIs

Create order

POST {API-HOST}/merchant-integration/v1/orders/web-payment

API to request payment via Payment Web

Request Body

{
  "data": {
    "expiration": 0,//expiration time in timestamp
    "order_id": "string"
    "payment_url": "string"//Payment Web URL 
    "qr_code": "string",
    "qr_data": "string",
    "qr_url": "string"
  },
  "meta": {
    "code": 0,
    "message": "string"
  },
}

Thông tin thêm:

Thông tin mã lỗi

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

APIs

Create Order

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

API to create new order

Request Body

{
    "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

{
  "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:

Bảng mã lỗi

Mobile SDK

Giới thiệu dịch vụ

Người dùng hiện nay đã không còn xa lạ với VinID Gift Card - là những chiếc thẻ cứng của VinID với những mệnh giá khác nhau từ 50.000đ đến 10.000.000đ sử dụng để nạp điểm thẻ vào tài khoản VinID của mình và tiêu dùng tại hệ sinh thái của Tập đoàn Vingroup và các đối tác của VinID.

Để nâng cao sự tiện lợi trong kỷ nguyên số, VinID cung cấp dịch vụ mua mã Giftcode cho phép đối tác tích hợp chủ động mua mã thẻ Gift Card để cung cấp đến người dùng cuối bằng hệ thống của chính mình. Người dùng thực hiện nạp mã vào tài khoản VinID để sử dụng.

Hướng dẫn cách sử dụng mã Giftcode

Cách 1: Nạp qua SMS Soạn tin nhắn theo cú pháp VinID[dấu cách][số thẻ VinID][dấu cách][mã nạp điểm] gửi đến 6067

Cách 2: Nạp qua ứng dụng VinID Truy cập ứng dụng VinID, trong mục Tiện ích, chọn Nạp điểm, nhập mã Giftcode và ấn Tiếp tục.

Luồng người dùng sử dụng dịch vụ

Đối tác có thể sử dụng Giftcode cho nhiều mục đích khác nhau tùy thuộc vào nghiệp vụ của mình như: mua bán, trao đổi, tặng thưởng, … Sơ đồ dưới đây minh họa cho nghiệp vụ Đổi VinID Giftcode của đối tác có hệ thống điểm loyalty riêng.

Sơ đồ xử lý kỹ thuật

APIs

Check quantity

POST {API-HOST}/merchant-integration/v1/gateway

API để kiểm tra số lượng giftcode còn lại trong kho của merchant.

Headers

Request Body

Withdraw Giftcode

POST {API-HOST}/merchant-integration/v1/gateway

API để lấy giftcode ra khỏi kho

Headers

Request Body

Check giftcode

POST {API-HOST}/merchant-integration/v1/gateway

API để kiểm tra trạng thái của giftcode

Headers

Request Body

Get order detail

POST {API-HOST}/merchant-integration/v1/gateway

API để yêu cầu lấy thông tin của đơn hàng đã thực hiện

Headers

Request Body

Mã lỗi

Xem thêm:

Giới thiệu dịch vụ

Dịch vụ chi hộ là giải pháp chuyển tiền dành cho các đối tác là tổ chức, doanh nghiệp, đơn vị kinh doanh đã đăng ký tại VinID có nhu cầu chuyển tiền cho cá nhân qua ví điện tử VinID Pay (nhân viên, khách hàng, đối tác...)

Dịch vụ chi hộ cung cấp cho đối tác phương thức chuyển tiền đơn giản, nhanh chóng. Người nhận sẽ nhận được tiền tức thời 24/7. Bên cạnh đó, lịch sử giao dịch sẽ được lưu lại, đảm bảo tra cứu hiệu quả, an toàn và bảo mật.

Đối tác sau khi ký hợp đồng sẽ được VinID hỗ trợ tích hợp kỹ thuật trong cả trong quá trình tích hợp và triển khai, sử dụng để đảm bảo vận hành trơn tru.

Lưu ý: Đối tác cần nạp tiền vào tài khoản ví khả dụng của mình trên VinID Pay. Cách nạp tiền:

• Bước 1: Đối tác chuyển tiền vào tài khoản của VinID Pay nội dung được VinID Pay cung cấp

• Bước 2: VinID Pay ghi tăng số dư Tài khoản ví của đối tác trên VinID Pay

• Bước 3: VinID Pay thông báo kết quả nạp tiền thành công

Luồng người dùng sử dụng dịch vụ

Sơ đồ xử lý kỹ thuật

APIs

Create Money transfer request

POST {API-HOST}/merchant-integration/v1/money-transfer/b2c

Request Body

{
  "data": {
    "transaction_id": "string",//mã của giao dịch tại hệ thống VinID
    "merchant_transaction_id": "string",
    "post_balance": 7795993 //Số dư sau giao dịch
  },
  "meta": {
    "code": int,
    "message": "string"
  }
}

Mã lỗi

Thông tin thêm:

Về thông tin tích hợp, vui lòng xem thông tin cụ thể trong các bài viết dưới đây:

• Dịch vụ lấy hạng thành viên trung thành

APIs

Check quantity

POST {API-HOST}/merchant-integration/v1/loyalty/gift-code/quantity

API để kiểm tra số lượng giftcode còn lại trong kho của merchant.

Request Body

{
  "meta": {
    "code": 200,
    "message": "OK"
  },
  "data": [
    {
      "card_type": "string",
      "quantity": 0
    }
  ]
}

Withdraw Giftcode

POST {API-HOST}/merchant-integration/v1/loyalty/gift-code/orders

API để lấy giftcode ra khỏi kho

Request Body

{
  "meta": {
    "code": int,
    "message": "string"
  },
  "data": {
    "created_at": 0,
    "extra_data: "string"
    "merchant_order_id": "string",
    "order_info": [
      {
        "card_type": "string", //Mệnh giá giftcode
        "cards": [
          {
            "code": "string", //Mã nạp của giftcode
            "expire_date": "string", //Ngày hết hạn
            "serial": "string" //Mã tra soát
          }
        ]
      }
    ]
  }

{
  "store_code": "string",
  "pos_code": "string",
  "merchant_order_id": "string",
  "order_info": [
    {
      "card_type": "string",
      "quantity": 10
    }
  ],
  "extra_data": "string"
}

Check giftcode

POST {API-HOST}/merchant-integration/v1/loyalty/gift-code/check

API để kiểm tra trạng thái của giftcode

Request Body

{
  "meta": {
    "code": int,
    "message": "string"
  },
  "data": {
    "status": "USED", //“USED” hoặc “ACTIVE”
    "expire_date": "yyyy-MM-dd" //Hạn sử dụng
  }
}

{
  "meta": {
    "code": int,
    "message": "string"
  },
  "data": }

Get order detail

GET {API-HOST}/merchant-integration/v1/loyalty/gift-code/orders?{parameters}

API để yêu cầu lấy thông tin của đơn hàng đã thực hiện

Path Parameters

{
  "meta": {
    "code": int,
    "message": "string"
  },
  "data": {
    "created_at": 0,
    "extra_data": "string",
    "merchant_order_id": "string",
    "order_info": [
      {
        "card_type": "string",
        "cards": [
          {
            "code": "string", //Mã nạp của giftcode
            "expire_date": "string", //Ngày hết hạn
            "serial": "string" //Mã tra soát
          }
        ]
      }
    ]   
  }

{API-HOST}/merchant-integration/v1/loyalty/giftcode/orders?merchant_order_id=string&store_code=string&pos_code=string

Mã lỗi

Xem thêm:

APIs

Get user info by phone number

GET {API-HOST}/merchant-integration/v1/loyalty/topup/member?{parameters}

API cho merchant để kiểm tra thông tin của số điện thoại người dùng.

Path Parameters

{
  "meta": {
    "code": int,
    "message": "string"
  },
  "data": {
    "full_name":        string,
    "phone_number":     string,
    "dob":              string,
    "gender":           string,
    "identify":         string,  // Số điện thoại cá nhân
    "status":           string,  // A: Active | I: Inactive | B: Block
    "card_status":      string   // A: Active | I: Inactive
  }
}

{API-HOST}/merchant-integration/v1/loyalty/topup/member?phone_number=string&store_code=string&pos_code=string

Top-up points to phone number

POST {API-HOST}/merchant-integration/v1/loyalty/topup

API để nạp điểm cho số điện thoại người dùng

Request Body

{
  "meta": {
    "code": 200,
    "message": "OK"
}

{
  "phone_number": "string",
  "store_code" : "string",
  "pos_code" : "string",
  "point_amount":2,
  "order_id": "string",
  "txn_id":"string",
  "send_receipt": true/false,
  "receipt_info": {
    "name": "string",
    "address": "string",
    "email": "string",
    "tax_code": "string"
    }
}

Query order status

GET {API-HOST}/merchant-integration/v1/loyalty/topup/status?{parameters}

API để kiểm tra trạng thái đơn hàng

Path Parameters

{
  "meta": {
    "code": int,
    "message": "string"
  },
  "data": {
    "type": "string", //TXN_SALE | TXN_EARN | TXN_BURN | TXN_REFUND
    "status": "string" //SUCCESS | ERROR
  }}

{API-HOST}/merchant-integration/v1/loyalty/topup/status?txn_id=string&store_code=string&pos_code=string

Mã lỗi

Xem thêm:

Giới thiệu dịch vụ

Là giải pháp giúp các bên đối tác lấy hạng của thành viên trung thành (vàng, bạc đồng) của VinID.

Khách hàng mua hàng, sử dụng dịch vụ của đối tác VinID khi đối tác không có hệ thống loyalty, khi thực hiện thanh toán bằng VinID, hệ thống sẽ lấy hạng thành viên của khách hàng. Theo đó, khách hàng sẽ được giảm giá dựa theo thứ hạng thành viên của mình trong VinID.

Luồng người dùng sử dụng dịch vụ

Sơ đồ xử lý kĩ thuật

APIs

Lấy thông tin hạng thành viên

GET {API_HOST}/merchant-integration/v1/loyalty/membership?id_type=string&identity=string&business_code=string&program_code=string

Path Parameters

{
  "data": {
    "member": {
      "member_code": "string",
      "full_name": "string"
    },
    "tier_info": {
      "tier_code": "string",
      "tier_name": "string",
      "description": "string"
    } 
  },
  "meta": {
    "code": int,
    "message": "string"
  }
}

Những mã lỗi có thể xảy ra

• 401005: identity_type not supported

• 400002: invalid phone_number format

• 401006: invalid customer id

• 401007: invalid loyalty business

• 401008: invalid loyalty program

• 500503: generic OLS error

Giới thiệu dịch vụ

Dịch vụ Topup VinID Point cho phép các đối tác tích hợp thực hiện nạp điểm VinID trực tiếp tới số điện thoại của người dùng. Chỉ cần số điện thoại đã đăng ký tài khoản VinID là người dùng sẽ nhận được điểm Vinpoint ngay vào tài khoản VinID mà không cần thực hiện bất cứ thao tác gì.

Luồng người dùng sử dụng dịch vụ

Đối tác có thể sử dụng Dịch vụ Topup VinID Point cho nhiều mục đích khác nhau tùy thuộc vào nghiệp vụ của mình như: mua bán điểm, trao đổi/tặng thưởng, … từ hệ thống của mình. Sơ đồ dưới đây minh họa cho nghiệp vụ Đổi điểm VinID của đối tác có hệ thống điểm loyalty riêng.

Sơ đồ xử lý kỹ thuật

APIs

Get user info by phone number

POST {API-HOST}/merchant-integration/v1/gateway

API cho merchant để kiểm tra thông tin của số điện thoại người dùng.

Headers

Request Body

Top-up points to phone number

POST {API-HOST}/merchant-integration/v1/gateway

API để nạp điểm cho số điện thoại người dùng

Headers

Request Body

Query order status

POST {API-HOST}/merchant-integration/v1/gateway

API để kiểm tra trạng thái đơn hàng

Headers