Nội dung trang này
Bắt đầu
Mới sử dụng Eppay? Ba bước sau bao gồm mọi thứ mà đơn vị bán hàng cần trước khi nhận khoản thanh toán tiền mã hóa đầu tiên.
1. Tạo tài khoản và xác minh email
Đăng ký tại eppay.io bằng email hoặc đăng nhập mạng xã hội (Google, Facebook). Xác minh địa chỉ nhận được trong hộp thư của bạn để chúng tôi có thể gửi thông báo thanh toán và cảnh báo bảo mật.
2. Thêm địa chỉ ví nhận tiền
Mở phần Cài đặt và dán địa chỉ ví bạn kiểm soát trên từng blockchain mà bạn dự định nhận thanh toán. Eppay không bao giờ giữ tiền — mọi khoản thanh toán đều được chuyển thẳng đến địa chỉ bạn thiết lập.
3. Tạo khóa API hoặc liên kết thanh toán
Với hóa đơn dùng một lần, hãy tạo Sản phẩm và chia sẻ liên kết thanh toán do chúng tôi lưu trữ. Với tích hợp thanh toán, hãy tạo khóa API trong tab API và gọi POST /api/v2/create-payment để tạo liên kết bằng chương trình.
Thanh toán & xác nhận
Eppay xử lý thanh toán stablecoin USDT và USDC trên các mạng dưới đây. Mỗi chuỗi có tốc độ xác nhận và mức phí khác nhau.
Các mạng được hỗ trợ
Ethereum, Binance Smart Chain (BSC), Polygon, Arbitrum, Avalanche, Fantom, Cronos, Celo và Cosmos. Chúng tôi tiếp tục bổ sung các chuỗi theo nhu cầu của đơn vị bán hàng — hãy cho chúng tôi biết bạn cần mạng nào.
Các token được hỗ trợ
USDT (Tether) và USDC (USD Coin) trên mọi chuỗi được hỗ trợ. Cả hai đều là stablecoin neo theo USD, nên số tiền khách hàng gửi khớp với mức giá bạn hiển thị khi thanh toán.
Xác nhận mất bao lâu?
Thời gian xác nhận phụ thuộc vào chuỗi. Trên BSC, Polygon và Arbitrum, thanh toán thường hoàn tất trong chưa đầy một phút. Trên Ethereum mainnet, dự kiến khoảng 1–3 phút trong điều kiện mạng bình thường, lâu hơn khi phí tăng vọt. Eppay đánh dấu khoản thanh toán là "hoàn tất" ngay khi giao dịch trên chuỗi đạt số xác nhận cần thiết.
Ai trả phí mạng lưới?
Khách hàng trả phí gas trên chuỗi mà họ chọn. Eppay không thu phí từ chính khoản thanh toán ngoài phí nền tảng được công bố trong bảng điều khiển tài khoản của bạn.
Nếu khách hàng trả thiếu thì sao?
Nếu khách hàng gửi ít hơn số tiền yêu cầu, khoản thanh toán sẽ được ghi nhận là thanh toán một phần và liên kết vẫn mở cho đến khi phần còn lại được gửi hoặc liên kết hết hạn. Việc hoàn tiền cho thanh toán một phần được xử lý trực tiếp giữa bạn và khách hàng; Eppay không giữ khoản tiền đó.
API & tích hợp
Eppay cung cấp REST API, ứng dụng Shopify và JavaScript SDK để nhúng thanh toán vào bất kỳ nền tảng web nào.
Tôi lấy khóa API ở đâu?
Đăng nhập, mở tab API từ bảng điều khiển và nhấp Create API Key. Mỗi khóa gắn với tài khoản của bạn và bạn có thể thu hồi hoặc thay đổi khóa bất cứ lúc nào. Hãy coi khóa API như mật khẩu và chỉ lưu trữ ở phía máy chủ.
Tôi nên dùng API v1 hay v2?
Hãy dùng v2 cho mọi tích hợp mới. Các endpoint v2 (POST /api/v2/create-payment, GET /api/v2/payments/{id}/status) là chuẩn được hỗ trợ. Các endpoint v1 vẫn phản hồi cho những bên gọi cũ nhưng không nên dùng cho công việc mới.
Các bạn có hỗ trợ webhook không?
Có. Hãy cấu hình URL webhook trong tài khoản của bạn và Eppay sẽ POST một payload JSON có chữ ký khi trạng thái thanh toán thay đổi. Hãy xác minh header chữ ký ở phía bạn trước khi tin tưởng sự kiện đó.
Tích hợp Shopify hoạt động thế nào?
Cài ứng dụng Eppay từ Shopify App Store, kết nối với tài khoản Eppay của bạn, và tiền mã hóa sẽ trở thành một tùy chọn thanh toán cho khách hàng. Tiền được chuyển vào ví bạn đã cấu hình trong Eppay; đơn hàng sẽ tự động được đánh dấu đã thanh toán trên Shopify sau khi giao dịch trên chuỗi được xác nhận.
Tài khoản & bảo mật
Một vài câu hỏi thường gặp về tài khoản:
Tôi quên mật khẩu
Hãy dùng liên kết "Quên mật khẩu" trên trang đăng nhập. Chúng tôi sẽ gửi email chứa liên kết đặt lại có hiệu lực trong 60 phút. Nếu không nhận được email, hãy kiểm tra thư rác và xác nhận địa chỉ bạn đã dùng để đăng ký.
Làm cách nào để bật xác thực hai yếu tố?
Mở phần cài đặt hồ sơ và làm theo trình hướng dẫn thiết lập 2FA. Chúng tôi khuyến nghị bật 2FA trước khi thêm địa chỉ ví hoặc tạo khóa API.
Tôi có thể đổi địa chỉ ví không?
Có. Cập nhật địa chỉ trong phần Cài đặt bất cứ lúc nào. Các khoản thanh toán sau đó sẽ đi đến địa chỉ mới. Những khoản đang trong quá trình xử lý vẫn chuyển đến địa chỉ đang hoạt động lúc liên kết thanh toán được tạo.
Khắc phục sự cố
Năm vấn đề chúng tôi gặp nhiều nhất và cách xử lý:
Khoản thanh toán của tôi bị kẹt ở trạng thái "đang chờ"
Đang chờ nghĩa là giao dịch đã được phát đi nhưng chưa đạt số xác nhận cần thiết trên chuỗi. Hãy tra mã băm giao dịch trên trình khám phá khối (etherscan.io cho Ethereum, bscscan.com cho BSC, polygonscan.com cho Polygon, v.v.) để xác nhận giao dịch đã được khai thác. Nếu trên chuỗi đã xác nhận nhưng sau 10 phút Eppay vẫn hiển thị đang chờ, hãy liên hệ với chúng tôi kèm mã băm giao dịch.
Khách hàng thanh toán nhầm chuỗi
Nếu bạn nhận được khoản thanh toán trên một chuỗi mà bạn kiểm soát với cùng địa chỉ ví (hầu hết các chuỗi EVM dùng chung định dạng địa chỉ), số tiền vẫn có thể lấy lại từ chuỗi đó. Nếu khách hàng gửi tới một chuỗi mà bạn không có khóa, rất tiếc số tiền đó không thể khôi phục thông qua Eppay.
Khóa API của tôi trả về 401 Unauthorized
Hãy kiểm tra bạn đã truyền khóa trong header Authorization dưới dạng Bearer token, khóa chưa bị thu hồi trong bảng điều khiển, và bạn đang gọi đúng môi trường. Tạo lại khóa là giải pháp cuối cùng.
Số tiền hiển thị không khớp với số đã gửi
Eppay báo giá bằng stablecoin (USDT hoặc USDC), nên 1 USDT vào bằng 1 USDT ra — không có quy đổi ngoại tệ. Nếu khách hàng gửi token khác (ví dụ ETH thay vì USDT) thì khoản thanh toán sẽ không khớp. Độ chính xác thập phân khác nhau theo từng chuỗi; mặc định chúng tôi hiển thị sáu chữ số thập phân.
Webhook của tôi không bao giờ được gọi
Hãy xác nhận URL có thể truy cập công khai (không phải localhost hay máy chủ chỉ dùng VPN), phản hồi HTTP 2xx trong vòng 5 giây, và không có tường lửa nào chặn IP của chúng tôi. Chúng tôi thử gửi lại các lần thất bại với khoảng cách tăng dần trong tối đa 24 giờ.
Thời gian phản hồi
Chúng tôi cố gắng trả lời mọi email trong vòng một ngày làm việc (Thứ Hai–Thứ Sáu). Các sự cố khẩn cấp làm gián đoạn thanh toán sẽ được ưu tiên. Giờ làm việc của chúng tôi theo Giờ Trung Âu, nhưng đội ngũ phân tán nhiều nơi nên thường phản hồi cả ngoài khung giờ đó.
Để được trả lời nhanh hơn, vui lòng đưa vào email đầu tiên: email tài khoản của bạn, ID thanh toán hoặc mã băm giao dịch nếu có liên quan, mạng lưới, và ảnh chụp màn hình hoặc thông báo lỗi.
Liên hệ hỗ trợ
Với các vấn đề kỹ thuật, tài khoản hoặc thanh toán, hãy gửi email cho chúng tôi:
info@eppay.io
Câu hỏi về kinh doanh & hợp tác
Với các đề nghị hợp tác, tích hợp quy mô lớn, điều khoản thanh toán tùy chỉnh hoặc câu hỏi từ báo chí, hãy gửi email tới info@eppay.io với tiêu đề "Partnership" kèm mô tả ngắn gọn về điều bạn đang xây dựng. Chúng tôi trả lời mọi yêu cầu hợp lệ trong vòng hai ngày làm việc.
Bạn đang tìm tài liệu kỹ thuật?
Tài liệu dành cho nhà phát triển của chúng tôi bao gồm toàn bộ tham chiếu API, payload webhook, cách dùng SDK và ví dụ mã nguồn bằng nhiều ngôn ngữ.
Mở tài liệu →