API tra cứu phiên thẻ

Nội dung Markdown đầy đủ của trang tài liệu.

# API tra cứu phiên thẻ

`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:

```json
{"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.

```json
{
  "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](/playground/card-popup/) · [Webhook](/docs/card-popup/webhook/)