{"info":{"name":"BOM.ASIA API v2","description":"Complete API collection for BOM.ASIA services including ZNS and Mobile Topup","schema":"https:\/\/schema.getpostman.com\/json\/collection\/v2.1.0\/collection.json","_postman_id":"6a255ab63823d","version":"2.0.0"},"auth":{"type":"apikey","apikey":[{"key":"key","value":"X-API-Key","type":"string"},{"key":"value","value":"{{api_public_key}}:{{api_secret_key}}","type":"string"},{"key":"in","value":"header","type":"string"}]},"variable":[{"key":"base_url","value":"https:\/\/bom.asia","type":"string"},{"key":"api_public_key","value":"your_public_key_here","type":"string"},{"key":"api_secret_key","value":"your_secret_key_here","type":"string"}],"item":[{"name":"Miniapp API","description":"Miniapp API endpoints","item":[{"name":"Mini App: Phone Verify","request":{"method":"POST","header":[{"key":"Content-Type","value":"application\/json","type":"text"}],"url":{"raw":"{{base_url}}api\/miniapp\/phone\/verify","host":["{{base_url}}"],"path":["api","miniapp","phone","verify"]},"description":"Execute Mini App: Phone Verify"}}]},{"name":"Miniapp-sample API","description":"Miniapp-sample API endpoints","item":[{"name":"Mini App: Active Campaign","request":{"method":"GET","header":[{"key":"Content-Type","value":"application\/json","type":"text"}],"url":{"raw":"{{base_url}}api\/miniapp\/sample\/{appId}\/campaign\/active","host":["{{base_url}}"],"path":["api","miniapp","sample","{appId}","campaign","active"]},"description":"Execute Mini App: Active Campaign"}},{"name":"Mini App: Roles","request":{"method":"GET","header":[{"key":"Content-Type","value":"application\/json","type":"text"}],"url":{"raw":"{{base_url}}api\/miniapp\/sample\/{appId}\/roles","host":["{{base_url}}"],"path":["api","miniapp","sample","{appId}","roles"]},"description":"Execute Mini App: Roles"}},{"name":"Mini App: Check Registered","request":{"method":"GET","header":[{"key":"Content-Type","value":"application\/json","type":"text"}],"url":{"raw":"{{base_url}}api\/miniapp\/sample\/{appId}\/check-registered","host":["{{base_url}}"],"path":["api","miniapp","sample","{appId}","check-registered"]},"description":"Execute Mini App: Check Registered"}},{"name":"Mini App: Register","request":{"method":"POST","header":[{"key":"Content-Type","value":"application\/json","type":"text"}],"url":{"raw":"{{base_url}}api\/miniapp\/sample\/{appId}\/register","host":["{{base_url}}"],"path":["api","miniapp","sample","{appId}","register"]},"description":"Execute Mini App: Register"}},{"name":"Mini App: Registration History","request":{"method":"GET","header":[{"key":"Content-Type","value":"application\/json","type":"text"}],"url":{"raw":"{{base_url}}api\/miniapp\/sample\/{appId}\/registrations","host":["{{base_url}}"],"path":["api","miniapp","sample","{appId}","registrations"]},"description":"Execute Mini App: Registration History"}},{"name":"Mini App: Registration Detail","request":{"method":"GET","header":[{"key":"Content-Type","value":"application\/json","type":"text"}],"url":{"raw":"{{base_url}}api\/miniapp\/sample\/{appId}\/registrations\/{id}","host":["{{base_url}}"],"path":["api","miniapp","sample","{appId}","registrations","{id}"]},"description":"Execute Mini App: Registration Detail"}}]},{"name":"Topup API","description":"Topup API endpoints","item":[{"name":"Mobile Topup","request":{"method":"POST","header":[{"key":"Content-Type","value":"application\/json","type":"text"}],"url":{"raw":"{{base_url}}\/api\/v2\/topup\/mobile","host":["{{base_url}}"],"path":{"1":"api","2":"v2","3":"topup","4":"mobile"}},"description":"Top up mobile phone credit for a single number"}},{"name":"Create Topup Campaign","request":{"method":"POST","header":[{"key":"Content-Type","value":"application\/json","type":"text"}],"url":{"raw":"{{base_url}}\/api\/v2\/topup\/campaigns","host":["{{base_url}}"],"path":{"1":"api","2":"v2","3":"topup","4":"campaigns"}},"description":"Create a new topup campaign for bulk sending"}},{"name":"Send Topup Campaign","request":{"method":"POST","header":[{"key":"Content-Type","value":"application\/json","type":"text"}],"url":{"raw":"{{base_url}}\/api\/v2\/topup\/campaigns\/{id}\/send","host":["{{base_url}}"],"path":{"1":"api","2":"v2","3":"topup","4":"campaigns","5":"{id}","6":"send"}},"description":"Execute a topup campaign to send credits to all recipients"}},{"name":"Get Topup History","request":{"method":"GET","header":[{"key":"Content-Type","value":"application\/json","type":"text"}],"url":{"raw":"{{base_url}}\/api\/v2\/topup\/history","host":["{{base_url}}"],"path":{"1":"api","2":"v2","3":"topup","4":"history"}},"description":"Get topup transaction history with filters"}},{"name":"Get Topup Balance","request":{"method":"GET","header":[{"key":"Content-Type","value":"application\/json","type":"text"}],"url":{"raw":"{{base_url}}\/api\/v2\/topup\/balance","host":["{{base_url}}"],"path":{"1":"api","2":"v2","3":"topup","4":"balance"}},"description":"Get remaining topup credits balance"}},{"name":"List Campaigns","request":{"method":"GET","header":[{"key":"Content-Type","value":"application\/json","type":"text"}],"url":{"raw":"{{base_url}}\/api\/v2\/topup\/campaigns","host":["{{base_url}}"],"path":{"1":"api","2":"v2","3":"topup","4":"campaigns"}},"description":"List all topup campaigns"}},{"name":"Get Campaign Details","request":{"method":"GET","header":[{"key":"Content-Type","value":"application\/json","type":"text"}],"url":{"raw":"{{base_url}}\/api\/v2\/topup\/campaigns\/{id}","host":["{{base_url}}"],"path":{"1":"api","2":"v2","3":"topup","4":"campaigns","5":"{id}"}},"description":"Get detailed information about a specific campaign"}},{"name":"Get Topup Analytics","request":{"method":"GET","header":[{"key":"Content-Type","value":"application\/json","type":"text"}],"url":{"raw":"{{base_url}}\/api\/v2\/topup\/analytics","host":["{{base_url}}"],"path":{"1":"api","2":"v2","3":"topup","4":"analytics"}},"description":"Get topup usage analytics and statistics"}}]},{"name":"Wallet API","description":"Wallet API endpoints","item":[{"name":"Get Wallet Balance","request":{"method":"GET","header":[{"key":"Content-Type","value":"application\/json","type":"text"}],"url":{"raw":"{{base_url}}\/api\/v2\/wallet\/balance","host":["{{base_url}}"],"path":{"1":"api","2":"v2","3":"wallet","4":"balance"}},"description":"Get current wallet balance directly from ZNSWallet"}}]},{"name":"Zalo_oa API","description":"Zalo_oa API endpoints","item":[{"name":"List Zalo OA Accounts","request":{"method":"GET","header":[{"key":"Content-Type","value":"application\/json","type":"text"}],"url":{"raw":"{{base_url}}\/api\/v2\/zalo-oa\/accounts","host":["{{base_url}}"],"path":{"1":"api","2":"v2","3":"zalo-oa","4":"accounts"}},"description":"List all Zalo Official Account accounts linked to authenticated customer. Returns full account metadata including oa_id (Zalo OA ID), oa_name, avatar_url, followers_count, status, is_verified, is_linked_to_zns, token_valid, promotion quota info."}},{"name":"Get Zalo OA Account Details","request":{"method":"GET","header":[{"key":"Content-Type","value":"application\/json","type":"text"}],"url":{"raw":"{{base_url}}\/api\/v2\/zalo-oa\/accounts\/{id}","host":["{{base_url}}"],"path":{"1":"api","2":"v2","3":"zalo-oa","4":"accounts","5":"{id}"}},"description":"Get detailed information about a specific Zalo OA account. Accepts either the internal id (integer) or the Zalo oa_id (string). Includes today limit info, promotion quota remaining, webhook settings."}},{"name":"List Zalo OA Contacts","request":{"method":"GET","header":[{"key":"Content-Type","value":"application\/json","type":"text"}],"url":{"raw":"{{base_url}}\/api\/v2\/zalo-oa\/contacts","host":["{{base_url}}"],"path":{"1":"api","2":"v2","3":"zalo-oa","4":"contacts"}},"description":"List all followers (contacts) of Zalo OAs owned by the authenticated customer. Supports filters: oa_account_id, is_follower, search (by name\/user_id\/alias), pagination (page, limit)."}},{"name":"Get Zalo OA Contact Details","request":{"method":"GET","header":[{"key":"Content-Type","value":"application\/json","type":"text"}],"url":{"raw":"{{base_url}}\/api\/v2\/zalo-oa\/contacts\/{id}","host":["{{base_url}}"],"path":{"1":"api","2":"v2","3":"zalo-oa","4":"contacts","5":"{id}"}},"description":"Get detailed information about a specific Zalo OA contact (follower). Accepts either the internal id (integer) or the Zalo user_id (string). Includes shared_info, tags, notes."}},{"name":"Calculate Zalo OA Message Pricing","request":{"method":"POST","header":[{"key":"Content-Type","value":"application\/json","type":"text"}],"url":{"raw":"{{base_url}}\/api\/v2\/zalo-oa\/calculate-pricing","host":["{{base_url}}"],"path":{"1":"api","2":"v2","3":"zalo-oa","4":"calculate-pricing"}},"description":"Calculate the price of sending a message BEFORE actually sending. Returns price, price_with_vat (10%), is_free flag, wallet_balance, wallet_sufficient flag. Message category (cs\/transaction\/promotion) is auto-derived from template.type."}},{"name":"Send Zalo OA Message","request":{"method":"POST","header":[{"key":"Content-Type","value":"application\/json","type":"text"}],"url":{"raw":"{{base_url}}\/api\/v2\/zalo-oa\/send","host":["{{base_url}}"],"path":{"1":"api","2":"v2","3":"zalo-oa","4":"send"}},"description":"Send messages via Zalo OA (CS, Transaction, or Promotion)"}},{"name":"Get Zalo OA Message History","request":{"method":"GET","header":[{"key":"Content-Type","value":"application\/json","type":"text"}],"url":{"raw":"{{base_url}}\/api\/v2\/zalo-oa\/messages","host":["{{base_url}}"],"path":{"1":"api","2":"v2","3":"zalo-oa","4":"messages"}},"description":"Get message sending history for Zalo OA"}},{"name":"Get Zalo OA Analytics","request":{"method":"GET","header":[{"key":"Content-Type","value":"application\/json","type":"text"}],"url":{"raw":"{{base_url}}\/api\/v2\/zalo-oa\/analytics","host":["{{base_url}}"],"path":{"1":"api","2":"v2","3":"zalo-oa","4":"analytics"}},"description":"Get analytics and statistics for Zalo OA messages"}},{"name":"List Zalo OA Templates","request":{"method":"GET","header":[{"key":"Content-Type","value":"application\/json","type":"text"}],"url":{"raw":"{{base_url}}\/api\/v2\/zalo-oa\/templates","host":["{{base_url}}"],"path":{"1":"api","2":"v2","3":"zalo-oa","4":"templates"}},"description":"Get all available Zalo OA message templates"}},{"name":"Get Zalo OA Balance","request":{"method":"GET","header":[{"key":"Content-Type","value":"application\/json","type":"text"}],"url":{"raw":"{{base_url}}\/api\/v2\/zalo-oa\/balance","host":["{{base_url}}"],"path":{"1":"api","2":"v2","3":"zalo-oa","4":"balance"}},"description":"Get wallet balance for Zalo OA messaging"}},{"name":"Send Free-text CS Message","request":{"method":"POST","header":[{"key":"Content-Type","value":"application\/json","type":"text"}],"url":{"raw":"{{base_url}}\/api\/v2\/zalo-oa\/send-text","host":["{{base_url}}"],"path":{"1":"api","2":"v2","3":"zalo-oa","4":"send-text"}},"description":"Send a free-text CS (customer service) message within the 48h reply window. No template required. Free of charge per Zalo policy."}}]},{"name":"Zns API","description":"Zns API endpoints","item":[{"name":"List ZNS Templates","request":{"method":"GET","header":[{"key":"Content-Type","value":"application\/json","type":"text"}],"url":{"raw":"{{base_url}}\/api\/v2\/zns\/templates","host":["{{base_url}}"],"path":{"1":"api","2":"v2","3":"zns","4":"templates"}},"description":"Get all available ZNS templates for authenticated user"}},{"name":"Get ZNS Template Details","request":{"method":"GET","header":[{"key":"Content-Type","value":"application\/json","type":"text"}],"url":{"raw":"{{base_url}}\/api\/v2\/zns\/templates\/{id}","host":["{{base_url}}"],"path":{"1":"api","2":"v2","3":"zns","4":"templates","5":"{id}"}},"description":"Get detailed information about a specific ZNS template including parameters"}},{"name":"Send ZNS Message","request":{"method":"POST","header":[{"key":"Content-Type","value":"application\/json","type":"text"}],"url":{"raw":"{{base_url}}\/api\/v2\/zns\/send","host":["{{base_url}}"],"path":{"1":"api","2":"v2","3":"zns","4":"send"}},"description":"Send a ZNS message to a single phone number","body":{"mode":"raw","raw":"{\n    \"phone\": \"0901234567\",\n    \"template_id\": \"123456\",\n    \"template_data\": {\n        \"customer_name\": \"Nguyen Van A\",\n        \"order_code\": \"ORD123\"\n    }\n}","options":{"raw":{"language":"json"}}}}},{"name":"Send ZNS OTP","request":{"method":"POST","header":[{"key":"Content-Type","value":"application\/json","type":"text"}],"url":{"raw":"{{base_url}}\/api\/v2\/zns\/send-otp","host":["{{base_url}}"],"path":{"1":"api","2":"v2","3":"zns","4":"send-otp"}},"description":"Send OTP via ZNS (optimized for OTP template)","body":{"mode":"raw","raw":"{\n    \"phone\": \"0901234567\",\n    \"template_id\": \"123456\",\n    \"template_data\": {\n        \"customer_name\": \"Nguyen Van A\",\n        \"order_code\": \"ORD123\"\n    }\n}","options":{"raw":{"language":"json"}}}}},{"name":"Send Bulk ZNS","request":{"method":"POST","header":[{"key":"Content-Type","value":"application\/json","type":"text"}],"url":{"raw":"{{base_url}}\/api\/v2\/zns\/send-bulk","host":["{{base_url}}"],"path":{"1":"api","2":"v2","3":"zns","4":"send-bulk"}},"description":"Send ZNS messages to multiple phone numbers in one request","body":{"mode":"raw","raw":"{\n    \"phone\": \"0901234567\",\n    \"template_id\": \"123456\",\n    \"template_data\": {\n        \"customer_name\": \"Nguyen Van A\",\n        \"order_code\": \"ORD123\"\n    }\n}","options":{"raw":{"language":"json"}}}}},{"name":"Get ZNS Send History","request":{"method":"GET","header":[{"key":"Content-Type","value":"application\/json","type":"text"}],"url":{"raw":"{{base_url}}\/api\/v2\/zns\/history","host":["{{base_url}}"],"path":{"1":"api","2":"v2","3":"zns","4":"history"}},"description":"Get ZNS send history with filters (date, status, etc.)"}},{"name":"Get ZNS Balance","request":{"method":"GET","header":[{"key":"Content-Type","value":"application\/json","type":"text"}],"url":{"raw":"{{base_url}}\/api\/v2\/zns\/balance","host":["{{base_url}}"],"path":{"1":"api","2":"v2","3":"zns","4":"balance"}},"description":"Get remaining ZNS credits balance"}},{"name":"Get ZNS Analytics","request":{"method":"GET","header":[{"key":"Content-Type","value":"application\/json","type":"text"}],"url":{"raw":"{{base_url}}\/api\/v2\/zns\/analytics","host":["{{base_url}}"],"path":{"1":"api","2":"v2","3":"zns","4":"analytics"}},"description":"Get ZNS usage analytics and statistics"}}]}]}