# Thanh toán thẻ nhúng Pay2S

Khách nhúng SDK Pay2S để mở form ePay trong modal ngay trên website. Hỗ trợ Visa, Mastercard, JCB, AMEX, UnionPay. Không cần QR hoặc trang chọn phương thức Pay2S.

## Các bước tích hợp

1. [Xác thực HMAC và client PHP/Node/Python](/docs/card-popup/authentication/).
2. [Lấy danh sách kết nối](/docs/card-popup/connections/) khi cấu hình; khách tự lưu connectionId. Không bắt buộc tạo cửa hàng.
3. [Tạo phiên](/docs/card-popup/create-session/) bằng connectionId đã lưu cho mỗi đơn; không lấy danh sách lại mỗi lần.
4. [Mở SDK modal](/docs/card-popup/sdk/), nhận trạng thái giao diện qua onStatus.
5. [Nhận webhook đã xác minh](/docs/card-popup/webhook/) và [tra cứu](/docs/card-popup/status/) để xử lý đơn đúng một lần.

## Điều kiện và phạm vi

Cần gói Basic trở lên còn hạn hoặc tài khoản demo, kết nối/thẻ được bật. Production cần phê duyệt phạm vi website/cửa hàng; demo chỉ sandbox. API kiểm tra quyền mỗi lần tạo phiên. Bộ này không bao gồm ví điện tử, POS, auto debit, hoàn tiền, lưu thẻ hoặc API hủy chủ động và không tự yêu cầu xuất HĐĐT.

Tạo phiên/đóng form không chứng minh thanh toán. HTTP status:true không phải paid. Chỉ xử lý đơn từ backend đã xác minh, khớp tài khoản, orderId, amount và environment.

## Thử nghiệm

[API Playground](/playground/card-popup/) · [Trải nghiệm](/demos/card-popup/) · [OpenAPI](/downloads/card-popup/openapi.json)

Playground dùng khóa ở server, gửi sandboxOnly=true, tối đa 10 đơn mỗi phiên trình duyệt, 2.000–1.000.000 VND. Các hạn mức trải nghiệm này không phải quota API merchant. Không nhập thẻ thật vào sandbox.

Tài liệu đối chiếu source hiện tại. Mẫu JSON/khóa/signature thử không dùng để thanh toán. Bộ kiểm thử dùng dữ liệu mô phỏng và SDK/CSS ePay đã tải; cần kiểm thử sandbox/3DS trên miền triển khai trước production.

## Không dùng SDK

Chọn checkoutMode=hosted để nhận paymentUrl và đưa khách sang trang thanh toán Pay2S hiện có. Cùng kết nối, trạng thái và webhook với SDK. [Request/response và mã PHP, Node.js, Python](/docs/card-popup/create-session/#trang-thanh-toan-pay2s-khong-can-sdk).