Xử lý kết quả thanh toán
Sau khi khách hàng hoàn tất quá trình thanh toán, hệ thống AppotaPay thông báo kết quả cho hệ thống của đối tác qua 2 hình thức
- Cần kiểm tra kĩ thông số trường status, orderAmount & signature phải hợp lệ trước khi xác nhận giao dịch thành công
- Nên gọi api check trạng thái giao dịch để đảm bảo kết quả được cập nhật chính xác nhất
- Sử dụng tham số
signature
để kiểm tra tính toàn vẹn của dữ liệu nhận được, phía đối tác tạo ra signature từ dữ liệu nhận được từ AppotaPay sau đó so sánh với tham sốsignature
AppotaPay gửi sang. - IPN chỉ trả khi giao dịch thành công
Redirect URL
- Khách hàng sẽ được điều hướng đến URL của phía đối tác đã truyền lên API qua tham số
redirectUrl
- Ở trang này phía đối tác kiểm tra dữ liệu, trạng thái giao dịch và hiển thị thông báo cho khách hàng.
Các tham số (query string) được gửi kèm vào URL
Method: GET
Tham số | Kiểu dữ liệu | Mô tả |
---|---|---|
data | String | Thông tin giao dịch ở dạng base64encode & json_encode |
signature | String | Chữ ký kiểm tra dữ liệu signature = |
time | String | Thời gian phản hồi |
Example result
data=eyJ0cmFuc2FjdGlvbiI6eyJlcnJvckNvZGUiOjAsIm1lc3NhZ2UiOiJUaFx1MDBlMG5oIGNcdTAwZjRuZyIsInBhcnRuZXJDb2RlIjoiVEVTVCIsImFwaUtleSI6Im9NaEpwa3o3SzZIRGNSNlMiLCJvcmRlckFtb3VudCI6NTAwMDAsImFtb3VudCI6NTAwMDAsImRpc2NvdW50QW1vdW50IjowLCJmZWVVc2VyIjowLCJzdGF0dXMiOiJzdWNjZXNzIiwiY3VycmVuY3kiOiJWTkQiLCJvcmRlcklkIjoiNWY1YjQ2Y2I3M2ZkMCIsImJhbmtDb2RlIjoiU0hCIiwicGF5bWVudE1ldGhvZCI6IkFUTSIsInBheW1lbnRUeXBlIjoiV0VCIiwiYXBwb3RhcGF5VHJhbnNJZCI6IkFQMjAwOTEwMDE0MTI1QiIsInRyYW5zYWN0aW9uVHMiOjE1OTk4MTc0MzMsImV4dHJhRGF0YSI6InRlc3QgdGVzdCJ9fQ==
&signature=9487dd169d2178b249d1503d2f2d7f01d1210517f6ae3a2703760cb218c838f3&time=53485768945
IPN (Instant Payment Notification)
AppotaPay sẽ gửi thông báo giao dịch qua API URL của phía đối tác đã gửi lên API qua tham số notifyUrl
, server phía đối tác kiểm tra tính toàn vẹn dữ liệu qua tham số signature
sau đó cập nhật trạng thái của đơn hàng.
Header
{
"Content-Type": "applicaton/json"
}
Response params
Phương thức: POST
Tham số | Kiểu dữ liệu | Mô tả |
---|---|---|
data | String | Thông tin giao dịch ở dạng base64encode & json_encode |
signature | String | Chữ ký kiểm tra dữ liệu signature = |
time | String | Thời gian phản hồi |