Nhà phát triển

Tích hợp trong bốn bước

REST API, JSON, yêu cầu có chữ ký. Tài liệu có ví dụ Node.js mở công khai, không cần đăng ký.

Tài liệu API Lấy khóa API

Bước 1
Ký yêu cầu
HMAC-SHA256 của dấu thời gian, phương thức, đường dẫn và hash nội dung. Khóa chỉ nằm trên máy chủ của bạn.
```
X-Shop-Id:    shop_…
X-Timestamp:  1793400000
X-Signature:  hex(HMAC-SHA256(secret_key,
  timestamp ⏎ METHOD ⏎ path ⏎ sha256(body)))
```

Bước 2

Tạo thanh toán

Số tiền theo đơn vị nhỏ nhất. Gửi lại với cùng Idempotency-Key sẽ trả về cùng một thanh toán.

POST /v1/payments
Idempotency-Key: 4f1c…

{ "orderId": "A-1001", "amount": 24990,
  "currency": "EUR",
  "returnUrl": "https://shop.example/thanks" }

Bước 3
Chuyển khách đi thanh toán
Trang thanh toán hiển thị phương thức theo quốc gia và tiền tệ, nhận tiền rồi đưa khách quay lại trang của bạn.
```
→ 201
{ "id": "pay_…", "status": "created",
  "checkoutUrl": "https://pay…/c/…" }
```
Bước 4
Nhận webhook
Kiểm tra chữ ký và đánh dấu đơn hàng đã thanh toán. Không có phản hồi 2xx, chúng tôi thử lại trong hai ngày.
```
POST https://shop.example/payos/webhook
X-Payos-Signature: v1=…

{ "type": "payment.succeeded",
  "data": { "orderId": "A-1001", … } }
```

Bắt đầu nhận thanh toán

Đăng ký và xác minh công ty trong bảng điều khiển. Khóa API được cấp ngay khi cửa hàng của bạn được duyệt.

Bắt đầu Tài liệu API