API phát hành thẻ
2328 là API phát hành thẻ ảo dành cho các nhóm muốn cung cấp thẻ thanh toán cho người dùng của họ mà không cần trở thành tổ chức phát hành được cấp phép. Bạn đăng ký chủ thẻ, phát hành thẻ theo BIN được tài trợ, nạp tiền từ ví USDT của bạn và kiểm soát toàn bộ vòng đời — đóng băng, hủy tải, đóng — thông qua một giao diện REST duy nhất.
Xây dựng chương trình thẻ theo cách truyền thống đòi hỏi giấy phép của tổ chức thẻ, BIN, bộ xử lý, ngân hàng tài trợ và mười tám tháng làm việc để chứng nhận trước khi ủy quyền đầu tiên được thông qua. Công việc đó đã được thực hiện ở đây. Phần còn lại về phía bạn là phần thực sự là sản phẩm của bạn: ai nhận được thẻ, họ có thể chi tiêu bao nhiêu và trải nghiệm trông như thế nào.
API chỉ sử dụng JSON, tất cả các trường đều là camelCase và mọi yêu cầu ngoại trừ kiểm tra tình trạng công khai đều được ủy quyền bằng khóa Bearer. Tiền luôn là một số nguyên trong các đơn vị nhỏ hơn với một loại tiền tệ và tỷ lệ rõ ràng — ví là USDT ở tỷ lệ 6, thẻ là USD ở tỷ lệ 2 — vì vậy không bao giờ có một số thập phân không rõ ràng trong sổ cái.
Chủ thẻ
Đăng ký chủ thẻ với dữ liệu nhận dạng mà chương trình yêu cầu, sau đó phát hành một hoặc nhiều thẻ cho mỗi người trong số họ. Quy trình giới thiệu, giới hạn và vòng đời được điều khiển hoàn toàn từ phía bạn.
Phát hành thẻ ảo tức thì
Thẻ được tạo bằng một lệnh gọi API duy nhất và có thể sử dụng ngay lập tức — không có thẻ vật lý, không vận chuyển, không bước kích hoạt. Phát hành một thẻ cho mỗi người dùng, mỗi đăng ký, mỗi chiến dịch hoặc mỗi nhà cung cấp.
Nạp tiền từ ví USDT
Thẻ được nạp tiền từ số dư stablecoin của bạn. USDT đến ở tỷ lệ 6, số dư thẻ là USD ở tỷ lệ 2 và API rõ ràng về cả hai để các sổ cái không bao giờ bị lệch.
Kiểm soát vòng đời đầy đủ
Đóng băng, mở đóng băng, rút tiền và đóng thẻ theo chương trình. Một thẻ bị xâm phạm sẽ bị vô hiệu hóa chỉ trong một yêu cầu; một gói đăng ký đã kết thúc sẽ không tốn phí để hủy bỏ.
Số dư và giao dịch
Đọc số dư thẻ trực tiếp và lịch sử giao dịch trên toàn bộ chương trình, bao gồm các ủy quyền, thanh toán, từ chối và phí.
Đơn hàng và webhook
Các hoạt động tiền tệ là không đồng bộ: bạn gửi một hoạt động, nhận một đơn hàng và coi webhook là nguồn thông tin đáng tin cậy thay vì giả định thành công khi nhận được mã 200.
Tài trợ BIN, không cần mất hai năm chờ đợi
Mỗi thẻ được gắn với một BIN — số này cho các mạng lưới thẻ biết tổ chức được cấp phép nào đứng sau nó. Để có BIN riêng, bạn cần trở thành thành viên chính của Visa hoặc Mastercard: giấy phép quy định, tài sản thế chấp của chương trình, yêu cầu về vốn và nhiều năm chứng nhận.
Thẻ được phát hành thông qua 2328 chạy trên một BIN được tài trợ hiện có. Tổ chức tài trợ nắm giữ tư cách thành viên chương trình và thanh toán với mạng lưới; bạn giữ sản phẩm, thương hiệu, mối quan hệ với chủ thẻ và lợi ích kinh tế. Trên thực tế, điều đó biến một dự án cấp phép thành một dự án tích hợp.
Quy trình giới thiệu vẫn là thẩm định thực tế — bạn sẽ được hỏi về chủ thẻ của mình là ai, tiền đến từ đâu và quy trình KYC cũng như giám sát của bạn như thế nào. Câu trả lời càng rõ ràng, chương trình càng bắt đầu nhanh chóng.
Quy trình tích hợp diễn ra như thế nào
- 1.Thống nhất chương trình: hồ sơ chủ thẻ, luồng cấp vốn, khu vực địa lý và giới hạn.
- 2.Nhận khóa API và kiểm tra kết nối với điểm cuối công khai GET /ping.
- 3.Đăng ký chủ thẻ đầu tiên của bạn và phát hành thẻ trong môi trường thực tế.
- 4.Nạp tiền vào thẻ từ ví USDT của bạn và xác nhận đơn hàng kết quả qua webhook.
- 5.Tích hợp số dư, giao dịch và các hoạt động vòng đời vào sản phẩm của bạn.
- 6.Triển khai và mở rộng quy mô — việc phát hành chỉ là một lệnh gọi duy nhất, vì vậy khối lượng không phải là vấn đề kỹ thuật.
Các câu hỏi thường gặp
Tôi có cần giấy phép hoặc BIN riêng để phát hành thẻ không?
Không. Thẻ được phát hành dưới một BIN được tài trợ hiện có, vì vậy bạn không cần phải trở thành thành viên chính của Visa hoặc Mastercard. Bạn mô tả chủ thẻ và luồng cấp vốn của mình trong quá trình giới thiệu; việc cấp phép và thanh toán chương trình thuộc về tổ chức tài trợ.
API phát hành thẻ sử dụng phương thức xác thực nào?
Xác thực Bearer. Mọi yêu cầu ngoại trừ kiểm tra tình trạng công khai đều mang Authorization: Bearer ck_{keyId}_{secret}. Khóa này xác định tài khoản của bạn, vì vậy không có ID người bán hoặc tài khoản nào được truyền trong payload. Chỉ giữ khóa trên backend của bạn.
Thẻ được nạp tiền như thế nào?
Từ ví USDT của bạn trong 2328. Việc nạp tiền chuyển đổi stablecoin thành số dư thẻ USD. Ví là USDT ở tỷ lệ 6 và thẻ là USD ở tỷ lệ 2 — số tiền luôn là số nguyên trong các đơn vị nhỏ hơn với một loại tiền tệ và tỷ lệ rõ ràng.
Các hoạt động thẻ có đồng bộ không?
Các hoạt động tiền tệ là không đồng bộ. Yêu cầu nạp tiền hoặc rút tiền trả về một đơn hàng mà bạn theo dõi cho đến khi hoàn tất, và một webhook xác nhận trạng thái cuối cùng. Các hoạt động đọc như số dư và giao dịch là đồng bộ.
Có môi trường sandbox không?
Chỉ có một môi trường thực tế — không có khóa sandbox riêng biệt. Một điểm cuối công khai GET /ping có sẵn mà không cần xác thực để kiểm tra tình trạng hoạt động.
Thẻ có thể được sử dụng để làm gì?
Các chương trình điển hình bao gồm đăng ký trực tuyến, chi tiêu quảng cáo, chi tiêu của nhân viên và nhà thầu, thanh toán thị trường và chi tiêu tiêu dùng được tài trợ bằng tiền điện tử nói chung. Các trường hợp sử dụng được phép sẽ được thống nhất trong quá trình giới thiệu chương trình.