Appearance
Collection Link
Khái niệm
Collection Link là API dùng để khởi tạo đơn hàng từ website merchant đến hệ thống Pay2S.
Luồng xử lý
- Khách hàng kiểm tra đơn hàng sau khi mua sắm trực tuyến.
- Người bán gửi yêu cầu đến Pay2S cho Liên kết thanh toán (kèm thông tin xác thực của người bán).
- Pay2S xác thực thông qua hồ sơ người bán và tạo liên kết thanh toán sau đó gửi lại cho người bán.
- Đơn vị bán hàng là kênh bán hàng trực tuyến, sau khi nhận được link hệ thống sẽ tự động chuyển đến trang thanh toán của Pay2S.
- Tùy từng thiết bị, Pay2S sẽ hiển thị giao diện web di động hoặc web tương ứng.
- Khách hàng kiểm tra thông tin đơn hàng, sau đó lựa chọn một trong các phương thức thanh toán của Pay2S.
- Chuyển hướng đến trang thanh toán theo cổng thanh toán khách hàng đã chọn.
- Sau khi quét QR Code trên máy tính để bàn hoặc mở trực tiếp từ Di động, khách hàng sẽ được chuyển đến màn hình xác nhận thanh toán an toàn, sau đó nhấp vào 'Xác nhận thanh toán'.
- Cổng thanh toán của Pay2S xử lý thanh toán, sau đó trả kết quả giao dịch thanh toán cho Người bán.
Cấu hình API
HTTP Request
- URL:
https://payment.pay2s.vn/v1/gateway/api/create
- Method:
POST
- Content-Type:
application/json; charset=UTF-8
Request Parameters
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. | |
requestId | String(50) | ✓ | Định danh duy nhất cho mỗi yêu cầu. |
amount | Long | ✓ | Số tiền cần thanh toán (VND). |
bankAccounts | String | ✓ | Mảng chứa các số tài khoản và Bank Code. |
orderId | String | ✓ | Mã đơn hàng của đối tác. |
orderInfo | String | ✓ | Thông tin đơn hàng. |
redirectUrl | String | ✓ | URL chuyển hướng sau khi thanh toán. |
ipnUrl | String | ✓ | API nhận kết quả thanh toán của đối tác. |
requestType | String | ✓ | Định danh kiểu của request. |
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&bankAccounts=Array&ipnUrl=$ipnUrl&orderId=$orderId&orderInfo=$orderInfo&partnerCode=$partnerCode&redirectUrl=$redirectUrl&requestId=$requestId&requestType=$requestType |
Sample Request
json
{
"partnerCode": "PAY2S",
"partnerName": "Test",
"requestType": "PAY2S",
"ipnUrl": "https://pay2s.vn",
"redirectUrl": "https://pay2s.vn",
"orderId": "MM1540456472575",
"amount": 150000,
"orderInfo": "SDK team.",
"bankAccounts": [
{
"account_number": "737478888",
"bank_id": "ACB"
},
{
"account_number": "222629219",
"bank_id": "ACB"
}
],
"requestId": "1540456472575",
"signature": "fd37abbee777e13eaa0d0690d184e4d7e2fb43977281ab0e20701721f07a0e07"
}