Hướng dẫn tạo liên kết thanh toán tự động – Collection Link API
Liên kết thanh toán tự động là gì ?
Liên kết thanh toán tự động là một cơ chế mà Pay2S cung cấp để tạo và quản lý các liên kết thanh toán, gọi là Collection Link API. API chính được sử dụng trong cơ chế này gọi là Payment Link API – API tạo liên kết thanh toán, được dùng để tạo ra đơn hàng trên hệ thống thanh toán một cách tự động, giúp kết nối giữa hệ thống website của merchant (người bán) và hệ thống xử lý thanh toán của Pay2S.
Cách hoạt động của Collection Link API
- Khởi tạo đơn hàng từ merchant (người bán): Khi khách hàng mua hàng trên website của merchant, hệ thống của merchant sẽ gửi thông tin đơn hàng (số tiền, nội dung thanh toán, thông tin khách hàng, v.v.) đến Pay2S thông qua Collection Link API.
- Tạo liên kết thanh toán: Sau khi nhận thông tin từ merchant, Pay2S sẽ tạo một liên kết thanh toán hoặc mã thanh toán tương ứng. Liên kết này được gửi lại cho merchant.
- Chuyển hướng khách hàng: Merchant sẽ hiển thị hoặc gửi liên kết này cho khách hàng, cho phép họ hoàn thành giao dịch thông qua Pay2S (bằng QR code ngân hàng, ví điện tử, hoặc các phương thức khác mà Pay2S hỗ trợ).
- Phản hồi trạng thái thanh toán: Sau khi khách hàng thanh toán, Pay2S sẽ gửi thông báo (callback hoặc webhook) về trạng thái thanh toán (thành công, thất bại, lỗi, v.v.) để merchant cập nhật tình trạng đơn hàng.
Lợi ích của Collection Link API
- Tự động hóa: Không cần xử lý thủ công việc tạo và gửi liên kết thanh toán.
- Tích hợp mượt mà: Kết nối trực tiếp giữa hệ thống merchant và Pay2S.
- Theo dõi giao dịch dễ dàng: Tất cả các đơn hàng và thanh toán được lưu trữ và quản lý tập trung trên hệ thống của Pay2S.
- Tăng cường trải nghiệm người dùng: Khách hàng nhận được quy trình thanh toán nhanh chóng và liền mạch.
Cấu hình Collection Link API
- Bước 1: Liên kết tài khoản vào Pay2S
- Bước 2: Lấy mã tương ứng tại mục Tích hợp Web/App
- Partner Code: Định danh duy nhất của tài khoản P2S của bạn
- Access Key: Mã cấp quyền truy cập vào hệ thống Pay2S.
- Secret Key: Dùng để tạo chữ ký điện tử digital signature.
- Bước 3: Cấu hình HTTP request
-
POSThttps://payment.pay2s.vn/v1/gateway/api/create
- Content-Type:
application/json
-
Request parameter
Key | Type | Required | Description |
---|---|---|---|
partnerCode | String | ✓ | Định danh duy nhất cho mỗi yêu cầu. |
partnerName | String | Tên đối tác. | |
requestType | String(50) | ✓ | Định danh kiểu của request. |
ipnUrl | String | ✓ | API nhận kết quả thanh toán của đối tác. |
redirectUrl | String | ✓ | URL chuyển hướng sau khi thanh toán. |
orderId | String | ✓ | Mã đơn hàng của đối tác. |
amount | Long | ✓ | Số tiền cần thanh toán (VND). |
orderInfo | String | ✓ | Thông tin đơn hàng. |
bankAccounts | String | ✓ | Mảng chứa các số tài khoản và Bank Code. |
requestId | String | ✓ | Định danh duy nhất cho mỗi yêu cầu. |
signature | String | ✓ | Chữ ký xác nhận giao dịch. Sử dụng thuật toán Hmac_SHA256 với data theo định dạng: 1 chuỗi String được sort theo thứ tự alphabet: accessKey=$accessKey&amount=$amount&accountNumber=$accountNumber&ipnUrl=$ipnUrl&orderId=$orderId&orderInfo=$orderInfo&partnerCode=$partnerCode&redirectUrl=$redirectUrl&requestId=$requestId&requestType=$requestType |
Mẫu nội dung
{
"partnerCode": "PAY2Sxxxxxxxxxxx",
"partnerName": "Pay2S - Giải pháp thanh toán tự động, biến động số dư",
"requestType": "PAY2S",
"ipnUrl": "https://pay2s.vn",
"redirectUrl": "https://pay2s.vn",
"orderId": "P2S1540456",
"amount": 150000,
"orderInfo": "WEB2M Team",
"bankAccounts": [
{
"account_number": "737478888",
"bank_id": "BIDV"
},
{
"account_number": "222629219",
"bank_id": "BIDV"
}
],
"requestId": "1540456472575",
"signature": "fd37abbee777e13eaa0d0690d184e4d7e2fb43977281ab0e20701721f07a0e07"
}
Code mẫu và demo Collection Link API
- Code mẫu: https://github.com/ThaiDuyKhang/collection-link-pay2s
- Demo: https://docs.pay2s.vn/example-collection-link/
Danh sách API ngân hàng tại Pay2S
- API ngân hàng BIDV: https://pay2s.vn/api-bidv
- API ngân hàng MB Bank: https://pay2s.vn/api-mb-bank
- API ngân hàng ACB: https://pay2s.vn/api-acb
Bài viết khác
Hướng dẫn nhận thông báo biến động số dư qua Telegram
Thông báo biến động số dư là gì ? Thông báo biến động số dư là giải pháp thông báo kết quả thanh toán tới…
Tặng 500K khi mở tài khoản ngân hàng BIDV với Pay2S
Mở tài khoản ngân hàng BIDV tại Pay2S, nhận ưu đãi đặc biệt Tặng 500.000 VNĐ khi mở tài khoản ngân hàng BIDV, đây là…
eKYC – Giải pháp định danh điện tử tiện lợi và an toàn trong ngành ngân hàng
eKYC là gì ? eKYC (Electronic Know Your Customer) là giải pháp xác minh danh tính của khách hàng thông qua việc ứng dụng công…
API MoMo
API MoMo (Ví điện tử MoMo) cung cấp khả năng tích hợp liền mạch giữa các ứng dụng, phần mềm và nền tảng số của…
Tải logo MoMo file Vector, AI, SVG, EPS, PNG
Ý nghĩa logo MoMo Logo Momo là sự kết hợp của icon, wordmark (Mobile Money) và background (hình vuông được bo góc hoặc hình tròn)…
API Techcombank
API Techcombank (Ngân hàng TMCP Kỹ Thương Việt Nam ) sử dụng chuẩn OpenAPI để cung cấp khả năng tích hợp liền mạch giữa các ứng…