Developer API
GoldData APIs
Danh sách endpoint, tham số và response mẫu để tích hợp ví, token và giao dịch vào hệ thống bên ngoài.
Base URL
https://www.golddata.vn/api/
Method
POST
Content-Type
application/x-www-form-urlencoded
Endpoints
10
Lưu ý tích hợp
Gửi dữ liệu bằng POST body dạng form-urlencoded. Các endpoint có ghi “Yêu cầu token” cần truyền token lấy từ trang hồ sơ hoặc endpoint đăng nhập.
POST
Không cần token
1. Lấy token người dùng
Xác thực tài khoản và trả về API token dùng cho các request ví/giao dịch.
Endpoint
https://www.golddata.vn/api/token.html
Parameters
| Field |
Type |
Diễn giải |
Demo |
user |
string |
Tên đăng nhập |
demo |
password |
string |
Mật khẩu |
demo |
Response mẫu
{"code":200,"result":"ef095ac8a83f60ea980652fe8d60d379","msg":""}
POST
Yêu cầu token
2. Tạo ví điện tử
Sinh một địa chỉ ví mới cho user sở hữu token.
Endpoint
https://www.golddata.vn/api/wallet_gen.html
Parameters
| Field |
Type |
Diễn giải |
Demo |
token |
string |
API token của user |
ef095ac8a83f60ea980652fe8d60d379 |
Response mẫu
{"code":200,"result":{"wallet":"xxx"},"msg":"Tạo ví thành công !"}
POST
Không cần token
3. Tạo link thanh toán
Tạo URL thanh toán/QR cho một ví nhận, số lượng và nội dung giao dịch.
Endpoint
https://www.golddata.vn/api/pay_gen.html
Parameters
| Field |
Type |
Diễn giải |
Demo |
wallet |
string |
Ví nhận |
QTE2MGY1NDNlMDRhZDc2MTYyNjY4NjQzMg |
amount |
decimal |
Số lượng token/ticket |
1.52 |
description |
string |
Nội dung giao dịch |
Test API |
callback |
url |
URL callback sau thanh toán |
https://www.golddata.vn/ |
Response mẫu
{"code":200,"result":"https://www.golddata.vn/pay/{wallet}/{amount}.html","msg":""}
POST
Yêu cầu token
4. Lấy danh sách ví
Trả về các ví thuộc user đang sở hữu API token.
Endpoint
https://www.golddata.vn/api/wallet_list.html
Parameters
| Field |
Type |
Diễn giải |
Demo |
token |
string |
API token của user |
ef095ac8a83f60ea980652fe8d60d379 |
Response mẫu
{"code":200,"result":[{"wallet":"xxx","amount_in_wallet":"0.00000000"}],"msg":""}
POST
Yêu cầu token
5. Kiểm tra số dư ví
Kiểm tra số ticket/token hiện có trong một địa chỉ ví.
Endpoint
https://www.golddata.vn/api/money_in_wallet.html
Parameters
| Field |
Type |
Diễn giải |
Demo |
token |
string |
API token của user |
ef095ac8a83f60ea980652fe8d60d379 |
wallet |
string |
Địa chỉ ví cần kiểm tra |
QTE2MGY1NDNlMDRhZDc2MTYyNjY4NjQzMg |
Response mẫu
{"code":200,"result":{"wallet":"QTE2MGY1NDNlMDRhZDc2MTYyNjY4NjQzMg","amount":"0.00000000"},"msg":""}
POST
Không cần token
6. Tìm giao dịch
Tìm danh sách giao dịch theo từ khóa và giới hạn số dòng trả về.
Endpoint
https://www.golddata.vn/api/transaction.html
Parameters
| Field |
Type |
Diễn giải |
Demo |
keyword |
string |
Từ khóa trong giao dịch |
Test API |
limit |
integer |
Số dòng tối đa |
10 |
Response mẫu
{"code":200,"result":[],"msg":""}
POST
Yêu cầu token
7. Lịch sử giao dịch ví
Lấy lịch sử chuyển/nhận của một ví theo API token.
Endpoint
https://www.golddata.vn/api/transaction_history.html
Parameters
| Field |
Type |
Diễn giải |
Demo |
token |
string |
API token của user |
ef095ac8a83f60ea980652fe8d60d379 |
wallet |
string |
Địa chỉ ví cần xem lịch sử |
QTE2MGY1NDNlMDRhZDc2MTYyNjY4NjQzMg |
Response mẫu
{"code":200,"result":[],"msg":""}
POST
Yêu cầu token
8. Tổng giá trị ví
Tính tổng số token/ticket trong các ví thuộc user.
Endpoint
https://www.golddata.vn/api/total_money.html
Parameters
| Field |
Type |
Diễn giải |
Demo |
token |
string |
API token của user |
ef095ac8a83f60ea980652fe8d60d379 |
Response mẫu
{"code":200,"result":"0.00000000","msg":""}
POST
Yêu cầu token
9. Chuyển token giữa ví
Thực hiện chuyển token/ticket từ ví nguồn sang ví nhận.
Endpoint
https://www.golddata.vn/api/transfer.html
Parameters
| Field |
Type |
Diễn giải |
Demo |
token |
string |
API token của user |
ef095ac8a83f60ea980652fe8d60d379 |
from_wallet |
string |
Ví nguồn |
QTE2MGY1NDNlMDRhZDc2MTYyNjY4NjQzMg |
to_wallet |
string |
Ví nhận |
QTE2MGYzMjE5NThiMjZjMTYyNjU0NjU4MQ |
amount |
decimal |
Số lượng cần chuyển |
1.52 |
description |
string |
Nội dung giao dịch |
Test API |
Response mẫu
{"code":200,"result":{"transaction_id":"xxx"},"msg":"Transfer success"}
POST
Yêu cầu token
10. Kiểm tra checksum
Tính checksum để đối chiếu dữ liệu giao dịch phía client/server.
Endpoint
https://www.golddata.vn/api/checksum.html
Parameters
| Field |
Type |
Diễn giải |
Demo |
token |
string |
API token của user |
ef095ac8a83f60ea980652fe8d60d379 |
ref |
string |
Mã tham chiếu giao dịch |
105 |
amount |
decimal |
Số lượng giao dịch |
1 |
from_wallet |
string |
Ví nguồn |
OWZmNDczNWZlNjNkNzU5MDRlMDJkZDc1NTA0YmEyNGQ |
to_wallet |
string |
Ví nhận |
YjY0YzM2YTZiMTk5OTA0YzFjYWJjNWUzMjBmNzQ0ODA |
Response mẫu
{"code":200,"checksum_transfer":"3152670793"}
Đang mở trang
Vui lòng chờ trong giây lát…