Tạo ví tĩnh

post

https://api.cryptomus.com/v1/wallet

Sao chép

Lời yêu cầu

Tham số truy vấn

Tên	Kiểu tham số	Giá trị mặc định	Sự định nghĩa
currency*	string		Mã tiền tệ
network*	string		Mã mạng Blockchain
order_id*	stringmin: 1max: 100alpha_dash		ID đơn hàng trong hệ thống của bạnTham số phải là một chuỗi bao gồm các ký tự chữ cái, số, dấu gạch dưới và dấu gạch ngang. Chuỗi không được chứa bất kỳ khoảng trắng hoặc ký tự đặc biệt nào. order_id phải là duy nhất trong hóa đơn của người bán/ví tĩnh/thanh toán định kỳKhi chúng tôi tìm thấy hóa đơn hiện có với order_id, chúng tôi sẽ trả về thông tin chi tiết của hóa đơn đó, hóa đơn mới sẽ không được tạo.
url_callback	stringmin: 6max: 255url	null	URL, nơi webhook sẽ được gửi đến sau mỗi lần nạp tiền vào ví
from_referral_code	string	null	Người bán đưa ra yêu cầu sẽ kết nối với người giới thiệu bằng mã.Ví dụ: bạn là một ứng dụng tạo hóa đơn thông qua API Cryptomus và khách hàng của bạn là các cửa hàng khác. Họ nhập khóa API và ID người bán vào ứng dụng của bạn, và bạn gửi yêu cầu kèm theo thông tin đăng nhập của họ và mã giới thiệu của bạn.Vì vậy, khách hàng của bạn sẽ trở thành người giới thiệu vào tài khoản Cryptomus của bạn và bạn sẽ nhận được thu nhập từ doanh thu của họ.

Kiểu tham số

string

Sự định nghĩa

Mã tiền tệ

Kiểu tham số

string

Sự định nghĩa

Mã mạng Blockchain

Kiểu tham số

stringmin: 1max: 100alpha_dash

Sự định nghĩa

ID đơn hàng trong hệ thống của bạnTham số phải là một chuỗi bao gồm các ký tự chữ cái, số, dấu gạch dưới và dấu gạch ngang. Chuỗi không được chứa bất kỳ khoảng trắng hoặc ký tự đặc biệt nào. order_id phải là duy nhất trong hóa đơn của người bán/ví tĩnh/thanh toán định kỳKhi chúng tôi tìm thấy hóa đơn hiện có với order_id, chúng tôi sẽ trả về thông tin chi tiết của hóa đơn đó, hóa đơn mới sẽ không được tạo.

Kiểu tham số

stringmin: 6max: 255url

Sự định nghĩa

URL, nơi webhook sẽ được gửi đến sau mỗi lần nạp tiền vào ví

Kiểu tham số

string

Sự định nghĩa

Người bán đưa ra yêu cầu sẽ kết nối với người giới thiệu bằng mã.Ví dụ: bạn là một ứng dụng tạo hóa đơn thông qua API Cryptomus và khách hàng của bạn là các cửa hàng khác.
Họ nhập khóa API và ID người bán vào ứng dụng của bạn, và bạn gửi yêu cầu kèm theo thông tin đăng nhập của họ và mã giới thiệu của bạn.Vì vậy, khách hàng của bạn sẽ trở thành người giới thiệu vào tài khoản Cryptomus của bạn và bạn sẽ nhận được thu nhập từ doanh thu của họ.

* - tham số bắt buộc

Ví dụ yêu cầu


curl https://api.cryptomus.com/v1/wallet \
-X POST \
-H 'merchant: 8b03432e-385b-4670-8d06-064591096795' \
-H 'sign: fe99035f86fa436181717b302b95bacff1' \
-H 'Content-Type: application/json' \
-d '{
    "currency": "USDT",
    "network": "tron", 
    "order_id": "1",
    "url_callback": "https://your.site/callback"
}'

Sao chép

Phản ứng

Các thông số phản hồi

Tên	Sự định nghĩa
wallet_uuid	uuid của ví của người bán
uuid	uuid của ví trong một mạng cụ thể
address	Địa chỉ ví trong một mạng cụ thể
network	Mã mạng ví
currency	Tiền tệ mạng ví
url	Liên kết đến biểu mẫu thanh toán

: Sự định nghĩa
uuid của ví của người bán
: Sự định nghĩa
uuid của ví trong một mạng cụ thể
: Sự định nghĩa
Địa chỉ ví trong một mạng cụ thể
: Sự định nghĩa
Mã mạng ví
: Sự định nghĩa
Tiền tệ mạng ví
: Sự định nghĩa
Liên kết đến biểu mẫu thanh toán

Ví dụ phản hồi


1{
2	"state": 0,
3	"result": {
4		"wallet_uuid": "de15b0f6-883f-4585-b27b-73a648044a92",
5		"uuid": "87961ae5-80c5-413a-a4fe-d38199894940",
6		"address": "TTEtddVZyNtLD9wbq4PzomjBhtxenSMXbb",
7		"network": "tron",
8		"currency": "USDT",
9		"url": "https://pay.cryptomus.com/wallet/3901446a-4b74-4796-b50a-14e14dafe3ed"
10	}
11}

Sao chép

Lỗi có thể xảy ra

Lỗi xác thực

mã số : 422

ví dụ phản hồi:

Nếu một số tham số là bắt buộc và không được truyền:


1{
2	"state": 1,
3	"errors": {
4		"currency": ["validation.required"]
5	}
6}

Sao chép

Nếu thanh toán của bạn bị chặn. Trong trường hợp này, bạn cần liên hệ với bộ phận hỗ trợ.


1{
2    "state": 1,
3    "message": "You are forbidden"
4}
5

Sao chép

Nếu chúng ta không tìm thấy dịch vụ thanh toán với loại tiền tệ và mạng lưới:


1{
2    "state": 1,
3    "message": "The service was not found"
4}

Sao chép

Nếu xảy ra sự cố kỹ thuật và tạm thời không thể thanh toán, bạn có thể nhận được thông báo lỗi này:


1{
2    "state": 1,
3    "message": "The terminal was not found"
4}

Sao chép


1{
2    "state": 1,
3    "message": "Server error"
4}

Sao chép


1{
2    "state": 1,
3    "message": "Wallet not found"
4}

Sao chép