@extends('layouts.app')
@section('title', 'Tích hợp API | GreenCard.vn')
@section('content')
</> Developer Hub
Tài liệu kết nối API Hệ thống
Kết nối cổng thanh toán tự động với độ trễ thấp (dưới 3 giây). Hỗ trợ nạp thẻ, mua gói game, xả thẻ cào
cấu trúc Callback thời gian thực tương thích hoàn toàn như cổng TheSieuRe.
{{-- Tab 1: API nạp thẻ điện thoại --}}
API Gửi Thẻ Cào / Nạp Tiền Điện Thoại
Endpoint này cho phép bạn đẩy thông tin thẻ cào mạng Viettel, Vinaphone, Mobifone hoặc thẻ dữ liệu lên hệ thống để nạp trực tiếp vào số tài khoản điện thoại khách hàng.
Khóa định danh đối tác, lấy trong trang Cấu hình API
sign
string
Chữ ký MD5 chống giả mạo dữ liệu
telco
string
Nhà mạng: VIETTEL, VINAPHONE, MOBIFONE...
amount
integer
Mệnh giá thẻ (VNĐ)
pin / serial
string
Mã thẻ và số serial in trên thẻ cào
request_id
string
Mã đơn hàng duy nhất phía đối tác
{{-- Tab 2: API nạp game --}}
API Mua Gói & Nạp Game Trực Tiếp
Hỗ trợ tích hợp nạp tài khoản vật phẩm trực tiếp thông qua Player ID của các dòng game hot trên thị trường (Garena, Zing, Gate, Razer...). Hệ thống xử lý thông lượng API lớn mà không bị treo hàng đợi.
Nhà phát hành / hệ game: GARENA, ZING, GATE, RAZER...
package_id
string
Mã gói nạp (ví dụ: diamonds_500)
player_id
string
ID nhân vật / UID người chơi cần nạp
request_id
string
Mã đơn hàng duy nhất phía đối tác
{{-- Tab 3: webhook gạch thẻ --}}
Webhook Callback Nhận Kết Quả Gạch Thẻ
Khi bạn gửi dữ liệu nạp thẻ cào (qua API gạch thẻ), hệ thống sẽ xử lý không đồng bộ. Sau khi nhà mạng trả về kết quả Thành công/Thất bại, máy chủ của chúng tôi sẽ gọi một `POST Request` trả ngược dữ liệu về đường dẫn URL Webhook của bạn.
Lưu ý quan trọng: Máy chủ của bạn bắt buộc phải phản hồi lại trạng thái `HTTP 200` kèm chuỗi JSON phản hồi hợp lệ để hệ thống ngừng gửi lại Callback. Nếu không nhận được HTTP 200, hệ thống sẽ tự động gọi lại 3 lần sau các khoảng 5 phút, 15 phút, 30 phút.
Dữ liệu Callback hệ thống bắn về Webhook của bạn
Đường dẫn nhận kết quả cấu hình trong Profile API của bạn.