PayME OpenEWallet SDK – Server Document

I. Giới thiệu

PayME OpenEWallet SDK là một nền tảng cung cấp Ví và các chức năng liên quan cho các đối tác của PayME tích hợp vào ứng dụng của đối tác.

Thuật ngữ

PayME Transaction - Mã giao dịch PAYME

PayME Transaction (viết tắt transaction) là một mã giao dịch Ví PayME tạo ra để định danh cho một giao dịch. Mã giao dịch này là duy nhất trên toàn hệ thống Ví PayME

Partner Transaction - Mã giao dịch đối tác

Partner Transaction (viết tắt partnerTransaction) là mã giao dịch đối tác gửi qua PayME để tiến hành thanh toán, mã giao dịch này cần là duy nhất trên mỗi merchantId và cũng là đối ứng 1 – 1 với transaction

II. Các tính năng chính

1. Thanh toán và IPN về cho đối tác

• Mô tả luồng xử lý

• Step 1 : Đối tác tiến hành giao dịch thông qua cổng thanh toán PayME, hoặc tạo QR thanh toán theo cấu trúc payME cung cấp
• Step 2 : Người dùng mở app đối tác đã tích hợp PayME SDK để quét QR của Cổng thanh toán PayME hoặc tự tạo ở bước 1
• Step 3: Người dùng chọn phương thức thanh toán do SDK cung cấp và tiến hành thanh toán
• Step 4 : Sau khi giao dịch thanh toán kết thúc, hệ thống Ví PayME sẽ thực hiện gọi IPN về IPN URL đã config trước của đối tác ở mục Thông tin kết nối

• Chi tiết

Chi tiết cách nhận dữ liệu IPN xem tại đây

https://docs.payme.vn/integrated/70#ipn-giao-dich-thanh-toan

• Phản hồi từ phía đối tác

Đối tác thực hiện phản hồi lại HTTP request trên với mã HTTP 200 và dữ liệu theo định dạng JSON theo cấu trúc sau:

Key	Type	Required	Mô Tả	Ghi chú
code	Int	YES	giá trị là 1000 nếu đối tác ghi nhận giao dịch thành công	Nếu giá trị khác 1000 (Hoặc phản hồi mã HTTP khác 200), hệ thống PayME sẽ thực hiện lại HTTP request trên tối đa 5 lần nữa đến khi nhận được giá trị là 1000 (mỗi lần thử lại cách nhau 5 giây)

Ví dụ:

{
 "code": 1000
}

• Trong trường hợp đối tác phản hồi không thành công, PayME sẽ tiến hành gọi lại giao dịch sau 5 giây, tối đa 5 lần.
• Nếu sau 5 lần gọi lại vẫn không có phản hồi từ đối tác, payME sẽ ngưng IPN giao dịch, đối tác sẽ gọi lại API tra cứu kết quả giao dịch của Cổng Thanh Toán để lấy kết quả nều cần thiết