API tra cứu phiên thẻ

✧ Mở bằng AI

Sao chép tài liệu, mở AI rồi dán vào cuộc trò chuyện.

POST https://payment.pay2s.vn/api/card-popup-session.php

Dùng cùng header/chữ ký như tạo phiên, nhưng ký body tra cứu:

{"action":"status","orderId":"ORDER001"}

API chỉ tra cứu đơn thuộc phạm vi khóa đang dùng. Không tìm thấy đơn trả HTTP 404.

{
  "status": true,
  "message": "OK",
  "data": {
    "sessionId": "<64 ký tự hex>",
    "orderId": "ORDER001",
    "environment": "sandbox",
    "status": "paid",
    "amount": 100000,
    "merchantOrigin": "https://shop.example.com",
    "expiresAt": 1792300000,
    "launched": true
  }
}

status	Cách xử lý
ready	Chưa gửi form thanh toán
pending	Chờ xác minh; chưa giao hàng, không tạo giao dịch thay thế
paid	Backend đã xác minh thanh toán; kiểm tra đơn/số tiền/môi trường trước khi xử lý
failed	Lần thanh toán thất bại
cancelled	Đơn đã được xác nhận hủy
review	Cần đối soát, không tự giao hàng hoặc tự kết luận thất bại
expired	Phiên chưa mở đã hết hạn

Phiên đã mở có thể tiếp tục pending sau thời hạn. Hết thời hạn liên kết không chứng minh tiền chưa được thu. Thành công đến muộn có thể cần đối soát.

Tra cứu đọc trạng thái đã lưu, không gọi trực tiếp ePay mỗi lần. IPN và cron MegaPay cập nhật trạng thái. SDK gọi backend merchant mỗi 4 giây và dừng khi có kết quả cuối hoặc sau 30 phút; backend merchant vẫn cần tiếp nhận webhook.

Thử tra cứu · Webhook