{
    "info": {
        "name": "API Collection - www.doithevip.com",
        "description": "Partner + Client API\nBase URL: https://www.doithevip.com\nImport vào Postman: File → Import → chọn file này.",
        "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
    },
    "variable": [
        {
            "key": "baseUrl",
            "value": "https://www.doithevip.com"
        }
    ],
    "item": [
        {
            "name": "Partner API",
            "description": "Partner API dùng partner_id + partner_key. Một số endpoint bắt buộc IP whitelist của merchant/admin. Base URL: domain website.",
            "item": [
                {
                    "name": "ĐỔI THẺ",
                    "item": [
                        {
                            "name": "Gửi thẻ lên hệ thống",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Content-Type",
                                        "value": "application/x-www-form-urlencoded"
                                    }
                                ],
                                "url": {
                                    "raw": "{{baseUrl}}/chargingws/v2",
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "path": [
                                        "chargingws",
                                        "v2"
                                    ]
                                },
                                "description": "Sign: md5(partner_key+code+serial) hoặc md5(partner_key+code+command+partner_id+request_id+serial+telco) khi checksign=1\n\nAuth: partner\n\nParams:\n- telco (required): Mạng thẻ, vd VIETTEL\n- code (required): Mã thẻ (PIN)\n- serial (required): Serial thẻ\n- amount (required): Mệnh giá khai báo\n- request_id (required): Mã yêu cầu duy nhất\n- partner_id (required): Partner ID\n- sign (required): Chữ ký MD5\n- command (required): charging",
                                "body": {
                                    "mode": "urlencoded",
                                    "urlencoded": [
                                        {
                                            "key": "telco",
                                            "value": "VIETTEL",
                                            "type": "text",
                                            "description": "Mạng thẻ, vd VIETTEL"
                                        },
                                        {
                                            "key": "code",
                                            "value": "123456789012",
                                            "type": "text",
                                            "description": "Mã thẻ (PIN)"
                                        },
                                        {
                                            "key": "serial",
                                            "value": "10001234567890",
                                            "type": "text",
                                            "description": "Serial thẻ"
                                        },
                                        {
                                            "key": "amount",
                                            "value": "50000",
                                            "type": "text",
                                            "description": "Mệnh giá khai báo"
                                        },
                                        {
                                            "key": "request_id",
                                            "value": "REQ-CHG-001",
                                            "type": "text",
                                            "description": "Mã yêu cầu duy nhất"
                                        },
                                        {
                                            "key": "partner_id",
                                            "value": "YOUR_PARTNER_ID",
                                            "type": "text",
                                            "description": "Partner ID"
                                        },
                                        {
                                            "key": "sign",
                                            "value": "REPLACE_WITH_MD5",
                                            "type": "text",
                                            "description": "Chữ ký MD5"
                                        },
                                        {
                                            "key": "command",
                                            "value": "charging",
                                            "type": "text",
                                            "description": "charging"
                                        }
                                    ]
                                }
                            },
                            "response": [
                                {
                                    "name": "99: Thẻ chờ xử lý",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/chargingws/v2"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"trans_id\": 1001,\n    \"request_id\": \"REQ-CHG-001\",\n    \"telco\": \"VIETTEL\",\n    \"serial\": \"10001234567890\",\n    \"code\": \"123456789012\",\n    \"declared_value\": 50000,\n    \"amount\": 47500,\n    \"value\": null,\n    \"status\": 99,\n    \"message\": \"PENDING\",\n    \"callback_sign\": \"...\"\n}"
                                },
                                {
                                    "name": "1: Thẻ thành công đúng mệnh giá",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/chargingws/v2"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"trans_id\": 1001,\n    \"request_id\": \"REQ-CHG-001\",\n    \"status\": 1,\n    \"message\": \"VALID_CARD\",\n    \"value\": 50000,\n    \"declared_value\": 50000,\n    \"amount\": 47500\n}"
                                },
                                {
                                    "name": "2: Thẻ thành công sai mệnh giá",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/chargingws/v2"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"trans_id\": 1001,\n    \"request_id\": \"REQ-CHG-001\",\n    \"status\": 2,\n    \"message\": \"CARD_WRONG_VALUE\",\n    \"value\": 20000,\n    \"declared_value\": 50000,\n    \"amount\": 19000\n}"
                                },
                                {
                                    "name": "3: Thẻ lỗi",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/chargingws/v2"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"request_id\": \"REQ-CHG-001\",\n    \"status\": 3,\n    \"message\": \"INVALID_CARD\"\n}"
                                },
                                {
                                    "name": "4: Hệ thống bảo trì",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/chargingws/v2"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"trans_id\": 0,\n    \"request_id\": \"REQ-CHG-001\",\n    \"status\": 4,\n    \"message\": \"Hệ thống bảo trì\"\n}"
                                },
                                {
                                    "name": "100: Gửi thẻ thất bại",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/chargingws/v2"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"trans_id\": 0,\n    \"request_id\": \"REQ-CHG-001\",\n    \"telco\": \"VIETTEL\",\n    \"serial\": \"10001234567890\",\n    \"code\": \"123456789012\",\n    \"declared_value\": 50000,\n    \"amount\": 0,\n    \"value\": null,\n    \"status\": 100,\n    \"message\": \"Sai chữ ký.\"\n}"
                                }
                            ]
                        },
                        {
                            "name": "Kiểm tra trạng thái thẻ",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Content-Type",
                                        "value": "application/x-www-form-urlencoded"
                                    }
                                ],
                                "url": {
                                    "raw": "{{baseUrl}}/chargingws/v2",
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "path": [
                                        "chargingws",
                                        "v2"
                                    ]
                                },
                                "description": "Sign: Giống gửi thẻ (khi checksign=1)\n\nAuth: partner\n\nParams:\n- command (required): check\n- request_id (required): Mã đã gửi\n- telco (required): Mạng thẻ\n- code (required): Mã thẻ\n- serial (required): Serial\n- amount (required): Mệnh giá khai báo\n- partner_id (required): Partner ID\n- sign (required): Chữ ký",
                                "body": {
                                    "mode": "urlencoded",
                                    "urlencoded": [
                                        {
                                            "key": "command",
                                            "value": "check",
                                            "type": "text",
                                            "description": "check"
                                        },
                                        {
                                            "key": "telco",
                                            "value": "VIETTEL",
                                            "type": "text",
                                            "description": "Mạng thẻ"
                                        },
                                        {
                                            "key": "code",
                                            "value": "123456789012",
                                            "type": "text",
                                            "description": "Mã thẻ"
                                        },
                                        {
                                            "key": "serial",
                                            "value": "10001234567890",
                                            "type": "text",
                                            "description": "Serial"
                                        },
                                        {
                                            "key": "amount",
                                            "value": "50000",
                                            "type": "text",
                                            "description": "Mệnh giá khai báo"
                                        },
                                        {
                                            "key": "request_id",
                                            "value": "REQ-CHG-001",
                                            "type": "text",
                                            "description": "Mã đã gửi"
                                        },
                                        {
                                            "key": "partner_id",
                                            "value": "YOUR_PARTNER_ID",
                                            "type": "text",
                                            "description": "Partner ID"
                                        },
                                        {
                                            "key": "sign",
                                            "value": "REPLACE_WITH_MD5",
                                            "type": "text",
                                            "description": "Chữ ký"
                                        }
                                    ]
                                }
                            },
                            "response": [
                                {
                                    "name": "99: Thẻ chờ xử lý",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/chargingws/v2"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"trans_id\": 1001,\n    \"request_id\": \"REQ-CHG-001\",\n    \"telco\": \"VIETTEL\",\n    \"serial\": \"10001234567890\",\n    \"code\": \"123456789012\",\n    \"declared_value\": 50000,\n    \"amount\": 47500,\n    \"value\": null,\n    \"status\": 99,\n    \"message\": \"PENDING\",\n    \"callback_sign\": \"...\"\n}"
                                },
                                {
                                    "name": "1: Thẻ thành công đúng mệnh giá",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/chargingws/v2"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"trans_id\": 1001,\n    \"request_id\": \"REQ-CHG-001\",\n    \"status\": 1,\n    \"message\": \"VALID_CARD\",\n    \"value\": 50000,\n    \"declared_value\": 50000,\n    \"amount\": 47500\n}"
                                },
                                {
                                    "name": "2: Thẻ thành công sai mệnh giá",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/chargingws/v2"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"trans_id\": 1001,\n    \"request_id\": \"REQ-CHG-001\",\n    \"status\": 2,\n    \"message\": \"CARD_WRONG_VALUE\",\n    \"value\": 20000,\n    \"declared_value\": 50000,\n    \"amount\": 19000\n}"
                                },
                                {
                                    "name": "3: Thẻ lỗi",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/chargingws/v2"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"request_id\": \"REQ-CHG-001\",\n    \"status\": 3,\n    \"message\": \"INVALID_CARD\"\n}"
                                },
                                {
                                    "name": "4: Hệ thống bảo trì",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/chargingws/v2"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"trans_id\": 0,\n    \"request_id\": \"REQ-CHG-001\",\n    \"status\": 4,\n    \"message\": \"Hệ thống bảo trì\"\n}"
                                },
                                {
                                    "name": "100: Gửi thẻ thất bại",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/chargingws/v2"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"trans_id\": 0,\n    \"request_id\": \"REQ-CHG-001\",\n    \"telco\": \"VIETTEL\",\n    \"serial\": \"10001234567890\",\n    \"code\": \"123456789012\",\n    \"declared_value\": 50000,\n    \"amount\": 0,\n    \"value\": null,\n    \"status\": 100,\n    \"message\": \"Sai chữ ký.\"\n}"
                                }
                            ]
                        },
                        {
                            "name": "Lấy giá đổi thẻ (mảng)",
                            "request": {
                                "method": "GET",
                                "header": [],
                                "url": {
                                    "raw": "{{baseUrl}}/chargingws/v2/getfee?partner_id=YOUR_PARTNER_ID",
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "path": [
                                        "chargingws",
                                        "v2",
                                        "getfee"
                                    ],
                                    "query": [
                                        {
                                            "key": "partner_id",
                                            "value": "YOUR_PARTNER_ID",
                                            "description": "Partner ID (query)"
                                        }
                                    ]
                                },
                                "description": "Sign: Không bắt buộc sign\n\nAuth: partner\n\nParams:\n- partner_id (required): Partner ID (query)"
                            },
                            "response": [
                                {
                                    "name": "Thành công",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [],
                                        "url": "{{baseUrl}}/chargingws/v2/getfee"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "[\n    {\n        \"telco\": \"VIETTEL\",\n        \"value\": 10000,\n        \"fees\": 20,\n        \"penalty\": 50\n    },\n    {\n        \"telco\": \"VIETTEL\",\n        \"value\": 50000,\n        \"fees\": 18,\n        \"penalty\": 50\n    },\n    {\n        \"telco\": \"MOBIFONE\",\n        \"value\": 10000,\n        \"fees\": 22,\n        \"penalty\": 50\n    }\n]"
                                }
                            ]
                        },
                        {
                            "name": "Lấy giá đổi thẻ (group telco)",
                            "request": {
                                "method": "GET",
                                "header": [],
                                "url": {
                                    "raw": "{{baseUrl}}/chargingws/price?partner_id=YOUR_PARTNER_ID",
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "path": [
                                        "chargingws",
                                        "price"
                                    ],
                                    "query": [
                                        {
                                            "key": "partner_id",
                                            "value": "YOUR_PARTNER_ID",
                                            "description": "Partner ID"
                                        }
                                    ]
                                },
                                "description": "Sign: Không bắt buộc sign\n\nAuth: partner\n\nParams:\n- partner_id (required): Partner ID"
                            },
                            "response": [
                                {
                                    "name": "Thành công",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [],
                                        "url": "{{baseUrl}}/chargingws/price"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"VIETTEL\": [\n        {\n            \"telco\": \"VIETTEL\",\n            \"value\": 10000,\n            \"fees\": 20,\n            \"penalty\": 50\n        }\n    ],\n    \"MOBIFONE\": [\n        {\n            \"telco\": \"MOBIFONE\",\n            \"value\": 10000,\n            \"fees\": 22,\n            \"penalty\": 50\n        }\n    ]\n}"
                                }
                            ]
                        },
                        {
                            "name": "Callback về bạn (POST JSON)",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    }
                                ],
                                "url": {
                                    "raw": "{{baseUrl}}/your-callback-url",
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "path": [
                                        "your-callback-url"
                                    ]
                                },
                                "description": "Sign: md5(partner_key+code+serial) — nếu dùng charging.callback riêng: md5(partner_id+code+serial)\n\nAuth: partner\n\nParams:\n- status (required): 1/2/3/4/99\n- message (required): VALID_CARD / ...\n- request_id (required): Mã đối tác\n- declared_value (required): Mệnh giá khai báo\n- value (optional): Mệnh giá tính tiền\n- card_value (optional): Mệnh giá thực thẻ\n- amount (optional): Số tiền nhận\n- code (required): PIN\n- serial (required): Serial\n- telco (required): Nhà mạng\n- trans_id (required): ID hệ thống\n- callback_sign (required): Chữ ký callback",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"status\": 1,\n    \"message\": \"VALID_CARD\",\n    \"request_id\": \"REQ-CHG-001\",\n    \"declared_value\": 50000,\n    \"value\": 50000,\n    \"card_value\": 50000,\n    \"amount\": 47500,\n    \"code\": \"123456789012\",\n    \"serial\": \"10001234567890\",\n    \"telco\": \"VIETTEL\",\n    \"trans_id\": 1001,\n    \"callback_sign\": \"REPLACE_WITH_MD5\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "Phản hồi từ phía bạn",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/your-callback-url"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"status\": \"success\"\n}"
                                }
                            ]
                        },
                        {
                            "name": "Callback về bạn (GET)",
                            "request": {
                                "method": "GET",
                                "header": [],
                                "url": {
                                    "raw": "{{baseUrl}}/your-callback-url?status=1&request_id=REQ-CHG-001&callback_sign=REPLACE_WITH_MD5",
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "path": [
                                        "your-callback-url"
                                    ],
                                    "query": [
                                        {
                                            "key": "status",
                                            "value": "1",
                                            "description": "1/2/3/4/99"
                                        },
                                        {
                                            "key": "request_id",
                                            "value": "REQ-CHG-001",
                                            "description": "Mã đối tác"
                                        },
                                        {
                                            "key": "callback_sign",
                                            "value": "REPLACE_WITH_MD5",
                                            "description": "Chữ ký"
                                        }
                                    ]
                                },
                                "description": "Sign: md5(partner_key+code+serial)\n\nAuth: partner\n\nParams:\n- status (required): 1/2/3/4/99\n- callback_sign (required): Chữ ký\n- request_id (required): Mã đối tác"
                            },
                            "response": [
                                {
                                    "name": "Phản hồi từ phía bạn",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [],
                                        "url": "{{baseUrl}}/your-callback-url"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"status\": \"success\"\n}"
                                }
                            ]
                        }
                    ]
                },
                {
                    "name": "KIỂM TRA SERI",
                    "item": [
                        {
                            "name": "Kiểm tra seri",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    }
                                ],
                                "url": {
                                    "raw": "{{baseUrl}}/api/verifycard",
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "path": [
                                        "api",
                                        "verifycard"
                                    ]
                                },
                                "description": "Sign: md5(partner_key + serial)\n\nAuth: partner\n\nParams:\n- partner_id (required): Partner ID\n- telco (required): Mạng thẻ\n- serial (required): Serial\n- sign (required): md5(partner_key+serial)",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"partner_id\": \"YOUR_PARTNER_ID\",\n    \"telco\": \"VIETTEL\",\n    \"serial\": \"10001234567890\",\n    \"sign\": \"REPLACE_WITH_MD5\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "Thành công",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/api/verifycard"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"status\": \"success\",\n    \"data\": {\n        \"status\": \"checked\",\n        \"serial\": \"10001234567890\",\n        \"card_status\": \"available\",\n        \"value\": 50000,\n        \"date_used\": null,\n        \"acc_charged\": null\n    }\n}"
                                },
                                {
                                    "name": "Sai chữ ký",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/api/verifycard"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"status\": \"invalid_sign\",\n    \"data\": null\n}"
                                }
                            ]
                        }
                    ]
                },
                {
                    "name": "MUA THẺ",
                    "item": [
                        {
                            "name": "Mua thẻ cào",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    }
                                ],
                                "url": {
                                    "raw": "{{baseUrl}}/api/cardws",
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "path": [
                                        "api",
                                        "cardws"
                                    ]
                                },
                                "description": "Sign: md5(partner_key + partner_id + command + request_id)\n\nAuth: partner\n\nParams:\n- partner_id (required): Partner ID\n- command (required): buycard\n- request_id (required): Mã duy nhất\n- service_code (required): Mã sản phẩm\n- value (required): Mệnh giá\n- qty (required): Số lượng\n- wallet_number (required): Số ví merchant\n- sign (required): Chữ ký",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"partner_id\": \"YOUR_PARTNER_ID\",\n    \"command\": \"buycard\",\n    \"request_id\": \"REQ-BUY-001\",\n    \"service_code\": \"VIETTEL\",\n    \"value\": 10000,\n    \"qty\": 1,\n    \"wallet_number\": \"YOUR_WALLET_NUM\",\n    \"sign\": \"REPLACE_WITH_MD5\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "1: Mua thẻ thành công",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/api/cardws"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"status\": 1,\n    \"message\": \"Mua thẻ thành công.\",\n    \"data\": {\n        \"cards\": [\n            {\n                \"name\": \"Viettel 10k\",\n                \"serial\": \"S1\",\n                \"code\": \"C1\",\n                \"expired\": \"2027-01-01\"\n            }\n        ],\n        \"time\": \"2026-07-25 09:00:00\",\n        \"request_id\": \"REQ-BUY-001\",\n        \"order_code\": \"SC123\"\n    }\n}"
                                },
                                {
                                    "name": "2: Thanh toán thành công, lấy thẻ thất bại",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/api/cardws"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"status\": 2,\n    \"message\": \"Thanh toan thanh cong. Lay the that bai, vui long redownload sau it phut\",\n    \"data\": false\n}"
                                },
                                {
                                    "name": "114: Merchant sai IP đăng ký",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/api/cardws"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"status\": 114,\n    \"message\": \"Merchant sai IP dang ky\",\n    \"data\": false\n}"
                                },
                                {
                                    "name": "116: Sai chữ ký",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/api/cardws"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"status\": 116,\n    \"message\": \"Sai chữ ký sign.\"\n}"
                                },
                                {
                                    "name": "130: Lỗi lấy thẻ",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/api/cardws"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"status\": 130,\n    \"message\": \"...\"\n}"
                                }
                            ]
                        },
                        {
                            "name": "Kiểm tra tồn kho",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    }
                                ],
                                "url": {
                                    "raw": "{{baseUrl}}/api/cardws",
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "path": [
                                        "api",
                                        "cardws"
                                    ]
                                },
                                "description": "Sign: md5(partner_key + partner_id + command + request_id) — bắt buộc\n\nAuth: partner\n\nParams:\n- partner_id (required): Partner ID\n- command (required): checkavailable\n- service_code (required): Mã SP\n- value (required): Mệnh giá\n- qty (required): Số lượng\n- wallet_number (required): Số ví\n- sign (required): Chữ ký\n- request_id (optional): Có thể rỗng khi ký",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"partner_id\": \"YOUR_PARTNER_ID\",\n    \"command\": \"checkavailable\",\n    \"service_code\": \"VIETTEL\",\n    \"value\": 10000,\n    \"qty\": 1,\n    \"wallet_number\": \"YOUR_WALLET_NUM\",\n    \"request_id\": \"\",\n    \"sign\": \"REPLACE_WITH_MD5\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "Còn hàng",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/api/cardws"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"stock_available\": true,\n    \"VT10\": \"Còn hàng\"\n}"
                                },
                                {
                                    "name": "Hết hàng",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/api/cardws"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"stock_available\": false,\n    \"VT10\": \"Hết hàng\"\n}"
                                }
                            ]
                        },
                        {
                            "name": "Tải lại thẻ",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    }
                                ],
                                "url": {
                                    "raw": "{{baseUrl}}/api/cardws",
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "path": [
                                        "api",
                                        "cardws"
                                    ]
                                },
                                "description": "Sign: md5(partner_key + partner_id + command + request_id)\n\nAuth: partner\n\nParams:\n- partner_id (required): Partner ID\n- command (required): redownload\n- request_id (required): request_id cũ\n- wallet_number (required): Số ví\n- sign (required): Chữ ký",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"partner_id\": \"YOUR_PARTNER_ID\",\n    \"command\": \"redownload\",\n    \"request_id\": \"REQ-BUY-001\",\n    \"wallet_number\": \"YOUR_WALLET_NUM\",\n    \"sign\": \"REPLACE_WITH_MD5\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "1 — Thành công",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/api/cardws"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"status\": 1,\n    \"data\": {\n        \"cards\": [\n            {\n                \"name\": \"Viettel 10k\",\n                \"serial\": \"S1\",\n                \"code\": \"C1\"\n            }\n        ],\n        \"request_id\": \"REQ-BUY-001\",\n        \"order_code\": \"SC123\"\n    }\n}"
                                },
                                {
                                    "name": "2 — Pending",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/api/cardws"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"status\": 2,\n    \"message\": \"Thanh toán thành công. Lấy thẻ thất bại, vui lòng redownload sau ít phút.\"\n}"
                                }
                            ]
                        },
                        {
                            "name": "Lấy số dư",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    }
                                ],
                                "url": {
                                    "raw": "{{baseUrl}}/api/cardws",
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "path": [
                                        "api",
                                        "cardws"
                                    ]
                                },
                                "description": "Sign: md5(partner_key + partner_id + command + request_id) — request_id có thể rỗng\n\nAuth: partner\n\nParams:\n- partner_id (required): Partner ID\n- command (required): getbalance\n- wallet_number (required): Số ví\n- sign (required): Chữ ký\n- request_id (optional): Có thể rỗng",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"partner_id\": \"YOUR_PARTNER_ID\",\n    \"command\": \"getbalance\",\n    \"request_id\": \"\",\n    \"wallet_number\": \"YOUR_WALLET_NUM\",\n    \"sign\": \"REPLACE_WITH_MD5\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "Thành công",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/api/cardws"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"balance\": 1500000,\n    \"currency_code\": \"VND\"\n}"
                                }
                            ]
                        },
                        {
                            "name": "Lấy danh sách thẻ",
                            "request": {
                                "method": "GET",
                                "header": [],
                                "url": {
                                    "raw": "{{baseUrl}}/api/cardws/products?partner_id=YOUR_PARTNER_ID",
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "path": [
                                        "api",
                                        "cardws",
                                        "products"
                                    ],
                                    "query": [
                                        {
                                            "key": "partner_id",
                                            "value": "YOUR_PARTNER_ID",
                                            "description": "Partner ID"
                                        }
                                    ]
                                },
                                "description": "Sign: Không bắt buộc sign\n\nAuth: partner\n\nParams:\n- partner_id (required): Partner ID"
                            },
                            "response": [
                                {
                                    "name": "Thành công",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [],
                                        "url": "{{baseUrl}}/api/cardws/products"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "[\n    {\n        \"name\": \"Viettel\",\n        \"slug\": \"viettel\",\n        \"service_code\": \"VIETTEL\",\n        \"image\": \"/upload/product/viettel.png\",\n        \"imgurl\": \"https://example.com/upload/product/viettel.png\",\n        \"cardvalue\": [\n            {\n                \"id\": 1,\n                \"service_code\": \"VIETTEL\",\n                \"value\": 10000,\n                \"discount\": 2.5,\n                \"price\": 9750\n            },\n            {\n                \"id\": 2,\n                \"service_code\": \"VIETTEL\",\n                \"value\": 20000,\n                \"discount\": 2.5,\n                \"price\": 19500\n            }\n        ]\n    }\n]"
                                }
                            ]
                        }
                    ]
                },
                {
                    "name": "NẠP TOPUP",
                    "item": [
                        {
                            "name": "Tạo lệnh nạp",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    }
                                ],
                                "url": {
                                    "raw": "{{baseUrl}}/api/rechargews",
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "path": [
                                        "api",
                                        "rechargews"
                                    ]
                                },
                                "description": "Sign: md5(partner_key + partner_id + command + request_id)\n\nAuth: partner\n\nParams:\n- partner_id (required): Partner ID\n- command (required): topup\n- request_id (required): Mã duy nhất\n- service_code (required): Key sản phẩm\n- amount (required): Mệnh giá/số tiền\n- account_info (required): Object tài khoản nhận (phone/...)\n- sign (required): Chữ ký",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"partner_id\": \"YOUR_PARTNER_ID\",\n    \"command\": \"topup\",\n    \"request_id\": \"REQ-TOP-001\",\n    \"service_code\": \"VIETTEL_TOPUP\",\n    \"amount\": 50000,\n    \"account_info\": {\n        \"phone\": \"0901234567\"\n    },\n    \"sign\": \"REPLACE_WITH_MD5\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "success",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/api/rechargews"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"status\": \"success\",\n    \"data\": {\n        \"time\": \"2026-07-25 09:00:00\",\n        \"request_id\": \"REQ-TOP-001\",\n        \"order_code\": \"RC123\",\n        \"pay_amount\": 49000,\n        \"discount\": 2,\n        \"service_code\": \"VIETTEL_TOPUP\",\n        \"amount\": 50000,\n        \"status\": \"pending\"\n    }\n}"
                                }
                            ]
                        },
                        {
                            "name": "Lấy trạng thái",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    }
                                ],
                                "url": {
                                    "raw": "{{baseUrl}}/api/rechargews",
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "path": [
                                        "api",
                                        "rechargews"
                                    ]
                                },
                                "description": "Sign: md5(partner_key + partner_id + command + request_id)\n\nAuth: partner\n\nParams:\n- partner_id (required): Partner ID\n- command (required): getstatus\n- request_id (required): request_id\n- order_code (required): Mã đơn hệ thống\n- sign (required): Chữ ký",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"partner_id\": \"YOUR_PARTNER_ID\",\n    \"command\": \"getstatus\",\n    \"request_id\": \"REQ-TOP-001\",\n    \"order_code\": \"RC123\",\n    \"sign\": \"REPLACE_WITH_MD5\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "pending",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/api/rechargews"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"status\": \"success\",\n    \"data\": {\n        \"account\": {\n            \"phone\": \"0901234567\"\n        },\n        \"request_value\": 50000,\n        \"amount\": 50000,\n        \"request_id\": \"REQ-TOP-001\",\n        \"order_code\": \"RC123\",\n        \"status\": \"pending\"\n    }\n}"
                                },
                                {
                                    "name": "completed",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/api/rechargews"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"status\": \"success\",\n    \"data\": {\n        \"request_id\": \"REQ-TOP-001\",\n        \"order_code\": \"RC123\",\n        \"status\": \"completed\"\n    }\n}"
                                },
                                {
                                    "name": "order_not_found",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/api/rechargews"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"status\": \"order_not_found\",\n    \"message\": \"...\"\n}"
                                }
                            ]
                        },
                        {
                            "name": "Lấy danh sách sản phẩm",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    }
                                ],
                                "url": {
                                    "raw": "{{baseUrl}}/api/rechargews",
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "path": [
                                        "api",
                                        "rechargews"
                                    ]
                                },
                                "description": "Sign: md5(partner_key + partner_id + command) — không ghép request_id\n\nAuth: partner\n\nParams:\n- partner_id (required): Partner ID\n- command (required): productlist\n- sign (required): Chữ ký",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"partner_id\": \"YOUR_PARTNER_ID\",\n    \"command\": \"productlist\",\n    \"sign\": \"REPLACE_WITH_MD5\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "success",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/api/rechargews"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"status\": \"success\",\n    \"data\": [\n        {\n            \"name\": \"Viettel Topup\",\n            \"service_code\": \"VIETTEL_TOPUP\",\n            \"type\": \"topup\",\n            \"items\": [\n                {\n                    \"name\": \"10.000đ\",\n                    \"value\": 10000,\n                    \"price\": 9800,\n                    \"discount\": 2\n                }\n            ],\n            \"options\": []\n        }\n    ]\n}"
                                }
                            ]
                        },
                        {
                            "name": "Lấy số dư",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    }
                                ],
                                "url": {
                                    "raw": "{{baseUrl}}/api/rechargews",
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "path": [
                                        "api",
                                        "rechargews"
                                    ]
                                },
                                "description": "Sign: md5(partner_key + partner_id + command) — không ghép request_id\n\nAuth: partner\n\nParams:\n- partner_id (required): Partner ID\n- command (required): getbalance\n- sign (required): Chữ ký",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"partner_id\": \"YOUR_PARTNER_ID\",\n    \"command\": \"getbalance\",\n    \"sign\": \"REPLACE_WITH_MD5\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "success",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/api/rechargews"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"status\": \"success\",\n    \"data\": {\n        \"balance\": 1500000,\n        \"currency\": \"VND\"\n    }\n}"
                                }
                            ]
                        },
                        {
                            "name": "Hủy lệnh nạp",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    }
                                ],
                                "url": {
                                    "raw": "{{baseUrl}}/api/rechargews",
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "path": [
                                        "api",
                                        "rechargews"
                                    ]
                                },
                                "description": "Sign: md5(partner_key + partner_id + command + request_id)\n\nAuth: partner\n\nParams:\n- partner_id (required): Partner ID\n- command (required): canceltopup\n- request_id (required): request_id\n- order_code (required): order_code\n- sign (required): Chữ ký",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"partner_id\": \"YOUR_PARTNER_ID\",\n    \"command\": \"canceltopup\",\n    \"request_id\": \"REQ-TOP-001\",\n    \"order_code\": \"RC123\",\n    \"sign\": \"REPLACE_WITH_MD5\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "success",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/api/rechargews"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"status\": \"success\",\n    \"data\": {\n        \"request_id\": \"REQ-TOP-001\",\n        \"order_code\": \"RC123\",\n        \"status\": \"canceled\"\n    }\n}"
                                }
                            ]
                        },
                        {
                            "name": "Bảng phí topup",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    }
                                ],
                                "url": {
                                    "raw": "{{baseUrl}}/api/rechargews",
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "path": [
                                        "api",
                                        "rechargews"
                                    ]
                                },
                                "description": "Sign: md5(partner_key + partner_id + command)\n\nAuth: partner\n\nParams:\n- partner_id (required): Partner ID\n- command (required): feetopup\n- sign (required): Chữ ký",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"partner_id\": \"YOUR_PARTNER_ID\",\n    \"command\": \"feetopup\",\n    \"sign\": \"REPLACE_WITH_MD5\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "success",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/api/rechargews"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"status\": \"success\",\n    \"data\": [\n        {\n            \"key\": \"VIETTEL_TOPUP\",\n            \"value\": 10000,\n            \"price\": 9800,\n            \"discount\": 2\n        }\n    ]\n}"
                                }
                            ]
                        }
                    ]
                }
            ]
        },
        {
            "name": "Client API",
            "description": "Client API dùng api_key của user (+ IP whitelist admin/user). Không có api_token, không ký MD5, không dùng partner_id. Có thể gửi kèm callback ở đổi thẻ / nạp topup. Envelope phổ biến: {status:number, message, data}.",
            "item": [
                {
                    "name": "VÍ NGƯỜI DÙNG",
                    "item": [
                        {
                            "name": "Lấy thông tin tài khoản",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    }
                                ],
                                "url": {
                                    "raw": "{{baseUrl}}/api/client/info",
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "path": [
                                        "api",
                                        "client",
                                        "info"
                                    ]
                                },
                                "description": "Sign: Không dùng sign\n\nAuth: client\n\nParams:\n- api_key (required): API key user",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"api_key\": \"YOUR_API_KEY\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "1 — Success",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/api/client/info"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"status\": 1,\n    \"message\": \"Success\",\n    \"data\": {\n        \"id\": 10,\n        \"username\": \"demo\",\n        \"email\": \"demo@example.com\",\n        \"phone\": \"0901234567\",\n        \"group\": 1\n    }\n}"
                                },
                                {
                                    "name": "16 — IP denied",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/api/client/info"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"status\": 16,\n    \"message\": \"ip_denied\",\n    \"data\": []\n}"
                                },
                                {
                                    "name": "15 — User not found",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/api/client/info"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"status\": 15,\n    \"message\": \"user_not_found\",\n    \"data\": []\n}"
                                }
                            ]
                        },
                        {
                            "name": "Lấy số dư",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    }
                                ],
                                "url": {
                                    "raw": "{{baseUrl}}/api/client/balance",
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "path": [
                                        "api",
                                        "client",
                                        "balance"
                                    ]
                                },
                                "description": "Sign: Không dùng sign\n\nAuth: client\n\nParams:\n- api_key (required): API key\n- currency_code (required): vd VND",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"api_key\": \"YOUR_API_KEY\",\n    \"currency_code\": \"VND\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "1 — Success",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/api/client/balance"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"status\": 1,\n    \"message\": \"success\",\n    \"data\": {\n        \"balance\": 1500000,\n        \"currency_code\": \"VND\"\n    }\n}"
                                },
                                {
                                    "name": "3 — Missing currency_code",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/api/client/balance"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"status\": 3,\n    \"message\": \"invalid_data\",\n    \"data\": []\n}"
                                },
                                {
                                    "name": "6 — Wallet not found",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/api/client/balance"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"status\": 6,\n    \"message\": \"Wallet not found\",\n    \"data\": []\n}"
                                }
                            ]
                        },
                        {
                            "name": "Danh sách ngân hàng rút",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    }
                                ],
                                "url": {
                                    "raw": "{{baseUrl}}/api/client/withdraw_banks",
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "path": [
                                        "api",
                                        "client",
                                        "withdraw_banks"
                                    ]
                                },
                                "description": "Sign: Không dùng sign\n\nAuth: client\n\nParams:\n- api_key (required): API key",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"api_key\": \"YOUR_API_KEY\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "1 — Success",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/api/client/withdraw_banks"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"status\": 1,\n    \"message\": \"Success\",\n    \"data\": [\n        [\n            {\n                \"id\": 1,\n                \"code\": \"Localbank_VCB\",\n                \"paygate\": \"Localbank\",\n                \"name\": \"Vietcombank\"\n            }\n        ]\n    ]\n}"
                                },
                                {
                                    "name": "18 — Not found",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/api/client/withdraw_banks"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"status\": 18,\n    \"message\": \"Withdraw bank not found\",\n    \"data\": []\n}"
                                }
                            ]
                        },
                        {
                            "name": "Rút tiền ví",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    }
                                ],
                                "url": {
                                    "raw": "{{baseUrl}}/api/client/withdraw",
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "path": [
                                        "api",
                                        "client",
                                        "withdraw"
                                    ]
                                },
                                "description": "Sign: Không dùng sign\n\nAuth: client\n\nParams:\n- api_key (required): API key\n- currency_code (required): VND\n- bank_code (required): vd Localbank_VCB\n- receive_account_number (required): STK nhận\n- receive_account_name (required): Tên TK\n- amount (required): Số tiền nhận\n- description (required): Nội dung (không chứa Thanhtoaninv)",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"api_key\": \"YOUR_API_KEY\",\n    \"currency_code\": \"VND\",\n    \"bank_code\": \"Localbank_VCB\",\n    \"receive_account_number\": \"0123456789\",\n    \"receive_account_name\": \"NGUYEN VAN A\",\n    \"amount\": 100000,\n    \"description\": \"RUTAPI001\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "1 — Success",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/api/client/withdraw"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"status\": 1,\n    \"message\": \"Success\",\n    \"data\": {\n        \"type\": \"Withdraw\",\n        \"order_code\": \"W123\",\n        \"net_amount\": 100000,\n        \"fees\": 1100,\n        \"pay_amount\": 101100,\n        \"status\": \"pending\"\n    }\n}"
                                },
                                {
                                    "name": "3 — Invalid data",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/api/client/withdraw"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"status\": 3,\n    \"message\": \"Invalid data\",\n    \"data\": []\n}"
                                },
                                {
                                    "name": "7 — Balance insufficient",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/api/client/withdraw"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"status\": 7,\n    \"message\": \"Balance insufficient\",\n    \"data\": []\n}"
                                },
                                {
                                    "name": "5 — Bank not support",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/api/client/withdraw"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"status\": 5,\n    \"message\": \"Not support this bank\",\n    \"data\": []\n}"
                                }
                            ]
                        },
                        {
                            "name": "Lấy thông tin đơn hàng",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    }
                                ],
                                "url": {
                                    "raw": "{{baseUrl}}/api/client/get_order",
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "path": [
                                        "api",
                                        "client",
                                        "get_order"
                                    ]
                                },
                                "description": "Sign: Không dùng sign\n\nAuth: client\n\nParams:\n- api_key (required): API key\n- order_code (required): Mã đơn",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"api_key\": \"YOUR_API_KEY\",\n    \"order_code\": \"W123\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "1 — Success",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/api/client/get_order"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"status\": 1,\n    \"message\": \"Success\",\n    \"data\": {\n        \"order_code\": \"W123\",\n        \"type\": \"Withdraw\",\n        \"status\": \"pending\"\n    }\n}"
                                },
                                {
                                    "name": "17 — Not found",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/api/client/get_order"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"status\": 17,\n    \"message\": \"Order not found\",\n    \"data\": []\n}"
                                }
                            ]
                        }
                    ]
                },
                {
                    "name": "ĐỔI THẺ",
                    "item": [
                        {
                            "name": "Gửi thẻ",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    }
                                ],
                                "url": {
                                    "raw": "{{baseUrl}}/api/client/charging/post",
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "path": [
                                        "api",
                                        "client",
                                        "charging",
                                        "post"
                                    ]
                                },
                                "description": "Sign: Không dùng sign\n\nGửi kèm callback (URL) để nhận kết quả async. Không gửi thì poll /api/client/charging/status. callback_sign = md5(code+serial).\n\ncallback (optional): URL hệ thống POST JSON khi thẻ có kết quả.\nKhông gửi callback thì dùng /api/client/charging/status với api_key + request_id.\ncallback_sign (Client) = md5(code + serial).\n\nAuth: client\n\nParams:\n- api_key (required): API key\n- telco (required): Mạng\n- code (required): PIN\n- serial (required): Serial\n- amount (required): Mệnh giá (hoặc post_value)\n- request_id (required): Mã duy nhất\n- callback (optional): URL nhận callback kết quả (tuỳ chọn)",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"api_key\": \"YOUR_API_KEY\",\n    \"telco\": \"VIETTEL\",\n    \"code\": \"123456789012\",\n    \"serial\": \"10001234567890\",\n    \"amount\": \"50000\",\n    \"request_id\": \"REQ-CHG-001\",\n    \"callback\": \"https://your-domain.com/callback/charging\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "PENDING",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/api/client/charging/post"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"trans_id\": 1001,\n    \"request_id\": \"REQ-CHG-001\",\n    \"status\": 99,\n    \"message\": \"PENDING\",\n    \"telco\": \"VIETTEL\",\n    \"declared_value\": 50000\n}"
                                },
                                {
                                    "name": "VALID_CARD",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/api/client/charging/post"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"trans_id\": 1001,\n    \"request_id\": \"REQ-CHG-001\",\n    \"status\": 1,\n    \"message\": \"VALID_CARD\",\n    \"value\": 50000\n}"
                                },
                                {
                                    "name": "19 — Fail",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/api/client/charging/post"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"status\": 19,\n    \"message\": \"...\",\n    \"data\": []\n}"
                                }
                            ]
                        },
                        {
                            "name": "Trạng thái thẻ",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    }
                                ],
                                "url": {
                                    "raw": "{{baseUrl}}/api/client/charging/status",
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "path": [
                                        "api",
                                        "client",
                                        "charging",
                                        "status"
                                    ]
                                },
                                "description": "Sign: Không dùng sign\n\nAuth: client\n\nParams:\n- api_key (required): API key\n- request_id (required): request_id",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"api_key\": \"YOUR_API_KEY\",\n    \"request_id\": \"REQ-CHG-001\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "1 — Success",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/api/client/charging/status"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"status\": 1,\n    \"message\": \"success\",\n    \"data\": {\n        \"trans_id\": 1001,\n        \"request_id\": \"REQ-CHG-001\",\n        \"status\": 1,\n        \"message\": \"VALID_CARD\"\n    }\n}"
                                },
                                {
                                    "name": "20 — Not found",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/api/client/charging/status"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"status\": 20,\n    \"message\": \"card_not_existed\",\n    \"data\": []\n}"
                                }
                            ]
                        },
                        {
                            "name": "Bảng phí đổi thẻ",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    }
                                ],
                                "url": {
                                    "raw": "{{baseUrl}}/api/client/charging/fee",
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "path": [
                                        "api",
                                        "client",
                                        "charging",
                                        "fee"
                                    ]
                                },
                                "description": "Sign: Không dùng sign\n\nAuth: client\n\nParams:\n- api_key (required): API key",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"api_key\": \"YOUR_API_KEY\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "1 — Success",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/api/client/charging/fee"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"status\": 1,\n    \"message\": \"success\",\n    \"data\": {\n        \"VIETTEL\": [\n            {\n                \"telco\": \"VIETTEL\",\n                \"value\": 10000,\n                \"fees\": 20,\n                \"penalty\": 50\n            }\n        ]\n    }\n}"
                                }
                            ]
                        },
                        {
                            "name": "Danh sách nhà mạng",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    }
                                ],
                                "url": {
                                    "raw": "{{baseUrl}}/api/client/product",
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "path": [
                                        "api",
                                        "client",
                                        "product"
                                    ]
                                },
                                "description": "Sign: Không dùng sign\n\nAuth: client\n\nParams:\n- api_key (required): API key\n- type (required): charging",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"api_key\": \"YOUR_API_KEY\",\n    \"type\": \"charging\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "1 — Success",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/api/client/product"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"status\": 1,\n    \"message\": \"success\",\n    \"data\": [\n        {\n            \"name\": \"Viettel\",\n            \"key\": \"VIETTEL\",\n            \"value\": [\n                10000,\n                20000,\n                50000\n            ],\n            \"icon\": \"https://example.com/vt.png\"\n        }\n    ]\n}"
                                }
                            ]
                        }
                    ]
                },
                {
                    "name": "MUA THẺ",
                    "item": [
                        {
                            "name": "Mua thẻ",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    }
                                ],
                                "url": {
                                    "raw": "{{baseUrl}}/api/client/softcard/buy",
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "path": [
                                        "api",
                                        "client",
                                        "softcard",
                                        "buy"
                                    ]
                                },
                                "description": "Sign: Không dùng sign\n\nClient softcard hiện không hỗ trợ callback; kết quả trả ngay hoặc poll /api/client/softcard/status.\n\nKhông hỗ trợ field callback. Dùng response ngay hoặc /api/client/softcard/status.\n\nAuth: client\n\nParams:\n- api_key (required): API key\n- qty (required): Số lượng\n- value (required): Mệnh giá\n- service_code (required): Mã SP\n- request_id (required): Mã duy nhất",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"api_key\": \"YOUR_API_KEY\",\n    \"qty\": 1,\n    \"value\": 10000,\n    \"service_code\": \"VIETTEL\",\n    \"request_id\": \"REQ-BUY-001\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "Success raw",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/api/client/softcard/buy"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"order_code\": \"SC123\",\n    \"time\": \"2026-07-27 10:00:00\",\n    \"cards\": [\n        {\n            \"name\": \"Viettel 10k\",\n            \"serial\": \"S1\",\n            \"code\": \"C1\",\n            \"expire\": \"2027-01-01\"\n        }\n    ]\n}"
                                },
                                {
                                    "name": "23 — insufficient_balance",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/api/client/softcard/buy"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"status\": 23,\n    \"message\": \"insufficient_balance\",\n    \"data\": []\n}"
                                }
                            ]
                        },
                        {
                            "name": "Tải lại / trạng thái đơn thẻ",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    }
                                ],
                                "url": {
                                    "raw": "{{baseUrl}}/api/client/softcard/status",
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "path": [
                                        "api",
                                        "client",
                                        "softcard",
                                        "status"
                                    ]
                                },
                                "description": "Sign: Không dùng sign\n\nAuth: client\n\nParams:\n- api_key (required): API key\n- request_id (required): request_id",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"api_key\": \"YOUR_API_KEY\",\n    \"request_id\": \"REQ-BUY-001\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "Completed raw",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/api/client/softcard/status"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"order_code\": \"SC123\",\n    \"time\": \"2026-07-27 10:00:00\",\n    \"cards\": [\n        {\n            \"name\": \"Viettel 10k\",\n            \"serial\": \"S1\",\n            \"code\": \"C1\"\n        }\n    ]\n}"
                                },
                                {
                                    "name": "28 — pending",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/api/client/softcard/status"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"status\": 28,\n    \"message\": \"order_is_pending\",\n    \"data\": []\n}"
                                }
                            ]
                        },
                        {
                            "name": "Kiểm tra tồn kho",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    }
                                ],
                                "url": {
                                    "raw": "{{baseUrl}}/api/client/softcard/available",
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "path": [
                                        "api",
                                        "client",
                                        "softcard",
                                        "available"
                                    ]
                                },
                                "description": "Sign: Không dùng sign\n\nAuth: client\n\nParams:\n- api_key (required): API key\n- qty (required): Số lượng\n- service_code (required): Mã SP\n- value (required): Mệnh giá",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"api_key\": \"YOUR_API_KEY\",\n    \"qty\": 1,\n    \"service_code\": \"VIETTEL\",\n    \"value\": 10000\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "1 — Success",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/api/client/softcard/available"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"status\": 1,\n    \"message\": \"success\",\n    \"data\": {\n        \"stock_available\": true,\n        \"VT10\": \"Còn hàng\"\n    }\n}"
                                }
                            ]
                        },
                        {
                            "name": "Danh sách thẻ",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    }
                                ],
                                "url": {
                                    "raw": "{{baseUrl}}/api/client/product",
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "path": [
                                        "api",
                                        "client",
                                        "product"
                                    ]
                                },
                                "description": "Sign: Không dùng sign\n\nAuth: client\n\nParams:\n- api_key (required): API key\n- type (required): softcard",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"api_key\": \"YOUR_API_KEY\",\n    \"type\": \"softcard\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "1 — Success",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/api/client/product"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"status\": 1,\n    \"message\": \"success\",\n    \"data\": [\n        {\n            \"name\": \"Viettel\",\n            \"service_code\": \"VIETTEL\",\n            \"image\": \"https://example.com/a.png\",\n            \"items\": [\n                {\n                    \"name\": \"10k\",\n                    \"value\": 10000,\n                    \"price\": 9750,\n                    \"discount\": 2.5,\n                    \"currency_code\": \"VND\"\n                }\n            ]\n        }\n    ]\n}"
                                }
                            ]
                        }
                    ]
                },
                {
                    "name": "NẠP TOPUP",
                    "item": [
                        {
                            "name": "Nạp topup",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    }
                                ],
                                "url": {
                                    "raw": "{{baseUrl}}/api/client/recharge/buy",
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "path": [
                                        "api",
                                        "client",
                                        "recharge",
                                        "buy"
                                    ]
                                },
                                "description": "Sign: Không dùng sign\n\nGửi kèm callback (URL) để nhận kết quả async. Không gửi thì poll /api/client/recharge/status. Client callback không kèm callback_sign.\n\ncallback (optional): URL hệ thống POST JSON khi topup có kết quả.\nKhông gửi callback thì dùng /api/client/recharge/status với api_key + request_id.\nClient API gửi thẳng URL callback — payload không có callback_sign.\n\nAuth: client\n\nParams:\n- api_key (required): API key\n- amount (required): Mệnh giá\n- service_code (required): Key SP\n- request_id (required): Mã duy nhất\n- account_info (required): Object tài khoản\n- callback (optional): URL nhận callback kết quả (tuỳ chọn)\n- qty (optional): Số lượng nếu cho phép",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"api_key\": \"YOUR_API_KEY\",\n    \"amount\": 50000,\n    \"service_code\": \"VIETTEL_TOPUP\",\n    \"request_id\": \"REQ-TOP-001\",\n    \"account_info\": {\n        \"phone\": \"0901234567\"\n    },\n    \"callback\": \"https://your-domain.com/callback/recharge\",\n    \"qty\": 1\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "1 — Success",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/api/client/recharge/buy"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"status\": 1,\n    \"message\": \"success\",\n    \"data\": {\n        \"time\": \"2026-07-27 10:00:00\",\n        \"request_id\": \"REQ-TOP-001\",\n        \"order_code\": \"RC123\",\n        \"pay_amount\": 49000,\n        \"amount\": 50000,\n        \"status\": \"pending\"\n    }\n}"
                                }
                            ]
                        },
                        {
                            "name": "Trạng thái topup",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    }
                                ],
                                "url": {
                                    "raw": "{{baseUrl}}/api/client/recharge/status",
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "path": [
                                        "api",
                                        "client",
                                        "recharge",
                                        "status"
                                    ]
                                },
                                "description": "Sign: Không dùng sign\n\nAuth: client\n\nParams:\n- api_key (required): API key\n- request_id (required): request_id\n- order_code (required): order_code",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"api_key\": \"YOUR_API_KEY\",\n    \"request_id\": \"REQ-TOP-001\",\n    \"order_code\": \"RC123\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "1 — pending/completed",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/api/client/recharge/status"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"status\": 1,\n    \"message\": \"success\",\n    \"data\": {\n        \"account\": {\n            \"phone\": \"0901234567\"\n        },\n        \"request_value\": 50000,\n        \"amount\": 50000,\n        \"request_id\": \"REQ-TOP-001\",\n        \"order_code\": \"RC123\",\n        \"status\": \"completed\"\n    }\n}"
                                },
                                {
                                    "name": "17 — Not found",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/api/client/recharge/status"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"status\": 17,\n    \"message\": \"Order not found\",\n    \"data\": []\n}"
                                }
                            ]
                        },
                        {
                            "name": "Danh sách sản phẩm topup",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Content-Type",
                                        "value": "application/json"
                                    }
                                ],
                                "url": {
                                    "raw": "{{baseUrl}}/api/client/product",
                                    "host": [
                                        "{{baseUrl}}"
                                    ],
                                    "path": [
                                        "api",
                                        "client",
                                        "product"
                                    ]
                                },
                                "description": "Sign: Không dùng sign\n\nAuth: client\n\nParams:\n- api_key (required): API key\n- type (required): recharge",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"api_key\": \"YOUR_API_KEY\",\n    \"type\": \"recharge\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "1 — Success",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [],
                                        "url": "{{baseUrl}}/api/client/product"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "body": "{\n    \"status\": 1,\n    \"message\": \"success\",\n    \"data\": [\n        {\n            \"name\": \"Viettel Topup\",\n            \"service_code\": \"VIETTEL_TOPUP\",\n            \"type\": \"topup\",\n            \"items\": [\n                {\n                    \"name\": \"10k\",\n                    \"value\": 10000,\n                    \"price\": 9800,\n                    \"discount\": 2\n                }\n            ],\n            \"options\": []\n        }\n    ]\n}"
                                }
                            ]
                        }
                    ]
                }
            ]
        }
    ]
}