{ "info": { "name": "TINGEE Open API (v1.2.2)", "description": "TINGEE API collection, generated automatically from the documentation at https://developers.tingee.vn/en.\n\nCollection variables: `clientId`, `secretKey`, `baseUrl` (defaults to UAT). The `x-signature` header is generated by the pre-request script.", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json" }, "event": [ { "listen": "prerequest", "script": { "type": "text/javascript", "exec": [ "(() => {", " const crypto = require('crypto-js');", " const ts = new Date(Date.now() + 7 * 60 * 60 * 1000).toISOString().replace(/[-:TZ.]/g, '').slice(0, 17);", " let body = '{}';", " if (pm.request.body && pm.request.body.mode === 'raw' && pm.request.body.raw && pm.request.body.raw.trim()) {", " body = JSON.stringify(JSON.parse(pm.variables.replaceIn(pm.request.body.raw)));", " }", " const secretKey = pm.variables.get('secretKey');", " if (!secretKey || secretKey === 'YOUR_SECRET_KEY') console.warn('secretKey chưa được cấu hình / secretKey is not set');", " const signature = crypto.HmacSHA512(ts + ':' + body, secretKey).toString(crypto.enc.Hex);", " pm.request.headers.upsert({ key: 'x-client-id', value: pm.variables.get('clientId') });", " pm.request.headers.upsert({ key: 'x-request-timestamp', value: ts });", " pm.request.headers.upsert({ key: 'x-signature', value: signature });", "})();" ] } } ], "variable": [ { "key": "baseUrl", "value": "https://uat-open-api.tingee.vn" }, { "key": "clientId", "value": "YOUR_CLIENT_ID" }, { "key": "secretKey", "value": "YOUR_SECRET_KEY" } ], "item": [ { "name": "Accounts & Identification", "item": [ { "name": "List supported banks and e-wallets", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/get-banks", "host": [ "{{baseUrl}}" ], "path": [ "v1", "get-banks" ] }, "description": "Get the full list of banks and e-wallets supported by Tingee, e.g. to let users pick one.\n\nDocumentation: https://developers.tingee.vn/en/docs/banking/get-banks" }, "response": [] }, { "name": "Query the account list", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/get-va-paging", "host": [ "{{baseUrl}}" ], "path": [ "v1", "get-va-paging" ] }, "description": "Get a paginated list of VAs. You can filter by creation time, bank code or account type.\n\nDocumentation: https://developers.tingee.vn/en/docs/banking/get-va-paging", "body": { "mode": "raw", "raw": "{\n \"skipCount\": 0,\n \"maxResultCount\": 10,\n \"bankBin\": \"970418\",\n \"accountType\": \"personal-account\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Create a virtual account (VA)", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/create-va", "host": [ "{{baseUrl}}" ], "path": [ "v1", "create-va" ] }, "description": "Start a request to create or link a virtual account with the bank. The result returns a confirmId to use in the next confirmation step.\n\nDocumentation: https://developers.tingee.vn/en/docs/banking/create-va", "body": { "mode": "raw", "raw": "{\n \"bankBin\": \"970418\",\n \"accountType\": \"personal-account\",\n \"accountNumber\": \"0935926988\",\n \"accountName\": \"NGUYEN THI HUYEN\",\n \"identity\": \"040191014068\",\n \"mobile\": \"0123456789\",\n \"isNotifyAccountNumber\": false\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Confirm a virtual account (VA)", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/confirm-va", "host": [ "{{baseUrl}}" ], "path": [ "v1", "confirm-va" ] }, "description": "Confirm a VA creation request with the confirmId received from the create-va API. Some banks also require otpNumber.\n\nDocumentation: https://developers.tingee.vn/en/docs/banking/confirm-va", "body": { "mode": "raw", "raw": "{\n \"bankBin\": \"970418\",\n \"confirmId\": \"886b05e9-2d94-4b41-9839-138c941fd1d9\",\n \"otpNumber\": \"123456\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Register for balance notifications (VA Notify)", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/register-notify", "host": [ "{{baseUrl}}" ], "path": [ "v1", "register-notify" ] }, "description": "Start a balance notification registration request. For some banks, the result includes a confirmId for the next verification step.\n\nDocumentation: https://developers.tingee.vn/en/docs/banking/register-notify", "body": { "mode": "raw", "raw": "{\n \"vaAccountNumber\": \"V1T199988811\",\n \"bankBin\": \"970416\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Confirm balance notification registration (VA Notify)", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/confirm-register-notify", "host": [ "{{baseUrl}}" ], "path": [ "v1", "confirm-register-notify" ] }, "description": "Confirm the registration request with the confirmId and the OTP (if any). After this step, balance notifications are officially activated for the virtual account.\n\nDocumentation: https://developers.tingee.vn/en/docs/banking/confirm-register-notify", "body": { "mode": "raw", "raw": "{\n \"bankBin\": \"970416\",\n \"confirmId\": \"886b05e9-2d94-4b41-9839-138c941fd1d9\",\n \"otpNumber\": \"123456\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Delete a virtual account (VA)", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/delete-va?bankBin=970422&vaAccountNumber=VQRs23GG4", "host": [ "{{baseUrl}}" ], "path": [ "v1", "delete-va" ], "query": [ { "key": "bankBin", "value": "970422" }, { "key": "vaAccountNumber", "value": "VQRs23GG4" } ] }, "description": "Send a VA deletion request. The bankBin and vaAccountNumber parameters are passed as Query Parameters.\n\nDocumentation: https://developers.tingee.vn/en/docs/banking/delete-va" }, "response": [] }, { "name": "Confirm virtual account (VA) deletion", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/confirm-delete-va", "host": [ "{{baseUrl}}" ], "path": [ "v1", "confirm-delete-va" ] }, "description": "Confirm a VA deletion request with the confirmId received from the delete-va API. Depending on the bank, you may also need to pass otpNumber.\n\nDocumentation: https://developers.tingee.vn/en/docs/banking/confirm-delete-va", "body": { "mode": "raw", "raw": "{\n \"bankBin\": \"970418\",\n \"confirmId\": \"72496bf2-ba25-4397-bd38-b9c04baedfd7\",\n \"otpNumber\": \"123456\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Register for debit notifications", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/create-debit", "host": [ "{{baseUrl}}" ], "path": [ "v1", "create-debit" ] }, "description": "Start a request to register for debit notifications on an ACB account. The result returns a confirmId used for the OTP confirmation step.\n\nDocumentation: https://developers.tingee.vn/en/docs/banking/create-debit", "body": { "mode": "raw", "raw": "{\n \"bankBin\": \"970416\",\n \"accountType\": \"personal-account\",\n \"accountNumber\": \"12345678\",\n \"accountName\": \"NGUYEN VAN A\",\n \"mobile\": \"0935926988\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Cancel debit notification registration", "request": { "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/delete-debit?bankBin=970416&vaAccountNumber=12345678", "host": [ "{{baseUrl}}" ], "path": [ "v1", "delete-debit" ], "query": [ { "key": "bankBin", "value": "970416" }, { "key": "vaAccountNumber", "value": "12345678" } ] }, "description": "Start a request to cancel debit notifications on an ACB account. The result returns a confirmId used for the OTP confirmation step.\n\nDocumentation: https://developers.tingee.vn/en/docs/banking/delete-debit" }, "response": [] }, { "name": "Transaction history", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/transaction/get-paging", "host": [ "{{baseUrl}}" ], "path": [ "v1", "transaction", "get-paging" ] }, "description": "Query the detailed transaction history. The result includes the amount, transaction type, time and transfer description.\n\nDocumentation: https://developers.tingee.vn/en/docs/banking/get-paging-transaction", "body": { "mode": "raw", "raw": "{\n \"skipCount\": 0,\n \"maxResultCount\": 50,\n \"vaAccountNumbers\": [\n \"88880935926988\"\n ],\n \"bankBin\": \"970418\",\n \"startTime\": \"20251001000000\",\n \"endTime\": \"20251010235959\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Bank Link SDK", "item": [ { "name": "Create a link session", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/create-bank-link-session", "host": [ "{{baseUrl}}" ], "path": [ "v1", "create-bank-link-session" ] }, "description": "Create a bank account link session to get the SDK URL to display on the client.\n\nDocumentation: https://developers.tingee.vn/en/docs/bank-link/create-session" }, "response": [] } ] } ] }, { "name": "Payment solutions", "item": [ { "name": "Payment gateway", "item": [ { "name": "Create a payment link", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/payment-gateway/create-link", "host": [ "{{baseUrl}}" ], "path": [ "v1", "payment-gateway", "create-link" ] }, "description": "Create a payment link (Checkout URL) to send to the customer.\n\nDocumentation: https://developers.tingee.vn/en/docs/payment-gateway/create-payment-link" }, "response": [] } ] }, { "name": "QR Code", "item": [ { "name": "Static QR Code", "item": [ { "name": "Create a static QR code (VietQR)", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/generate-viet-qr", "host": [ "{{baseUrl}}" ], "path": [ "v1", "generate-viet-qr" ] }, "description": "Create a static QR code in the VietQR standard. Customers can scan it to transfer money manually to your account.\n\nDocumentation: https://developers.tingee.vn/en/docs/qr/static/generate-viet-qr", "body": { "mode": "raw", "raw": "{\n \"bankBin\": \"970418\",\n \"accountNumber\": \"21510002865945\",\n \"amount\": 100000,\n \"content\": \"Thanh toan don hang\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] } ] }, { "name": "Dynamic QR Code", "item": [ { "name": "Create a dynamic QR code (Dynamic QR)", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/generate-dynamic-qr", "host": [ "{{baseUrl}}" ], "path": [ "v1", "generate-dynamic-qr" ] }, "description": "Create a dynamic QR code for each transaction. The result includes the QR code string and the bill information in the system.\n\nDocumentation: https://developers.tingee.vn/en/docs/qr/dynamic/generate-dynamic-qr", "body": { "mode": "raw", "raw": "{\n \"vaAccountNumber\": \"V1T199988811\",\n \"qrCodeType\": \"dynamic-one-time-payment\",\n \"bankBin\": \"970418\",\n \"amount\": 500000,\n \"purpose\": \"Thanh toan cho hoa don HD2918732312\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Delete a dynamic QR code (Dynamic QR)", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/delete-dynamic-qr", "host": [ "{{baseUrl}}" ], "path": [ "v1", "delete-dynamic-qr" ] }, "description": "Deactivate a dynamic QR code. After deletion, customers can no longer pay with this QR code.\n\nDocumentation: https://developers.tingee.vn/en/docs/qr/dynamic/delete-dynamic-qr", "body": { "mode": "raw", "raw": "{\n \"qrAccount\": \"V1TQRD7F3A9C1B2E4\",\n \"billId\": \"V1TQRD7F3A9C1B2E4\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Get dynamic QR code status", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/get-status-dynamic-qr", "host": [ "{{baseUrl}}" ], "path": [ "v1", "get-status-dynamic-qr" ] }, "description": "Check the status of a dynamic QR code. The result includes the bill information and related transactions (if any).\n\nDocumentation: https://developers.tingee.vn/en/docs/qr/dynamic/get-status-dynamic-qr", "body": { "mode": "raw", "raw": "{\n \"qrAccount\": \"V1TQRD7F3A9C1B2E4\",\n \"billId\": \"V1TQRD7F3A9C1B2E4\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] } ] } ] }, { "name": "Pay by Bank", "item": [ { "name": "Create a Deep Link", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/deep-link/generate", "host": [ "{{baseUrl}}" ], "path": [ "v1", "deep-link", "generate" ] }, "description": "Create a Deep Link for opening a payment app, making a transfer or paying a bill.\n\nDocumentation: https://developers.tingee.vn/en/docs/deeplink/deep-link", "body": { "mode": "raw", "raw": "{\n \"type\": \"qr-code\",\n \"qrCode\": \"base64_data\",\n \"redirectUrl\": \"https://your-app.com/callback\",\n \"bankBin\": \"970422\",\n \"accountNumber\": \"0123456789\",\n \"amount\": 50000,\n \"content\": \"Thanh toan don hang\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] } ] }, { "name": "POS payments", "item": [ { "name": "Create a POS order", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/create-pos-bill", "host": [ "{{baseUrl}}" ], "path": [ "v1", "create-pos-bill" ] }, "description": "Create a payment order on a Payoo POS terminal. The returned billId is used for lookup, cancellation and Webhook reconciliation.\n\nDocumentation: https://developers.tingee.vn/en/docs/pos-bill/create-pos-bill", "body": { "mode": "raw", "raw": "{\n \"bankBin\": \"PAYOO\",\n \"vaAccountNumber\": \"POS00012345\",\n \"amount\": 150000,\n \"paymentMethod\": \"card\",\n \"purpose\": \"Thanh toan don hang DH001\",\n \"expireInMinute\": 30,\n \"extraInfo\": \"DH001\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "POS order details", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/get-detail-pos-bill?bankBin=PAYOO&vaAccountNumber=POS00012345&billId=9f1c2b7e4a5d4c3b8e2f1a0b9c8d7e6f", "host": [ "{{baseUrl}}" ], "path": [ "v1", "get-detail-pos-bill" ], "query": [ { "key": "bankBin", "value": "PAYOO" }, { "key": "vaAccountNumber", "value": "POS00012345" }, { "key": "billId", "value": "9f1c2b7e4a5d4c3b8e2f1a0b9c8d7e6f" } ] }, "description": "Look up POS order details by billId.\n\nDocumentation: https://developers.tingee.vn/en/docs/pos-bill/get-detail-pos-bill" }, "response": [] }, { "name": "Cancel a POS order", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/update-pos-bill", "host": [ "{{baseUrl}}" ], "path": [ "v1", "update-pos-bill" ] }, "description": "Cancel a POS order by billId on the Payoo system.\n\nDocumentation: https://developers.tingee.vn/en/docs/pos-bill/update-pos-bill", "body": { "mode": "raw", "raw": "{\n \"bankBin\": \"PAYOO\",\n \"vaAccountNumber\": \"POS00012345\",\n \"billId\": \"9f1c2b7e4a5d4c3b8e2f1a0b9c8d7e6f\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] } ] }, { "name": "Direct Debit", "item": [ { "name": "Link an account", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/direct-debit/register", "host": [ "{{baseUrl}}" ], "path": [ "v1", "direct-debit", "register" ] }, "description": "Create a request to link a bank account. Returns a URL where the user completes the verification steps on the Tingee interface.\n\nDocumentation: https://developers.tingee.vn/en/docs/direct-debit/register", "body": { "mode": "raw", "raw": "{\n \"requestId\": \"550760e0-1cc2-44b9-85ba-eb318e228b4d\",\n \"phone\": \"0974444479\",\n \"returnUrl\": \"https://example.com\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Pay a bill", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/direct-debit/payment-bill", "host": [ "{{baseUrl}}" ], "path": [ "v1", "direct-debit", "payment-bill" ] }, "description": "Request a bill payment from a linked customer account. Supports automatic payment or payment with confirmation.\n\nDocumentation: https://developers.tingee.vn/en/docs/direct-debit/payment-bill", "body": { "mode": "raw", "raw": "{\n \"requestId\": \"550760e0-1cc2-44b9-85ba-eb318e228b4f\",\n \"subscriptionId\": \"89188e53-eba3-40fa-9323-04422ced3637\",\n \"tokenRef\": \"TKN-123456789\",\n \"amount\": \"500000\",\n \"description\": \"THANH TOAN HOA DON DV HD123456\",\n \"partnerCode\": \"one-pay\",\n \"serviceProviderName\": \"Công ty TMCP ABC\",\n \"returnUrl\": \"https://example.com\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Unlink an account", "request": { "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/direct-debit/delete-subscription", "host": [ "{{baseUrl}}" ], "path": [ "v1", "direct-debit", "delete-subscription" ] }, "description": "Create a request to unlink a bank account. The unlinking either completes immediately or returns an OTP verification URL.\n\nDocumentation: https://developers.tingee.vn/en/docs/direct-debit/delete-subscription", "body": { "mode": "raw", "raw": "{\n \"requestId\": \"550760e0-1cc2-44b9-85ba-eb318e228b4f\",\n \"subscriptionId\": \"89188e53-eba3-40fa-9323-04422ced3637\",\n \"tokenRef\": \"TKN-12345678\",\n \"returnUrl\": \"https://example.com\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Refund a transaction", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/direct-debit/refund", "host": [ "{{baseUrl}}" ], "path": [ "v1", "direct-debit", "refund" ] }, "description": "Request a refund for a successful transaction. Supports partial or full refunds.\n\nDocumentation: https://developers.tingee.vn/en/docs/direct-debit/refund", "body": { "mode": "raw", "raw": "{\n \"subscriptionId\": \"89188e53-eba3-40fa-9323-04422ced3637\",\n \"tokenRef\": \"TKN-12345678\",\n \"transactionId\": \"550760e0-1cc2-44b9-85ba-eb318e228b4f\",\n \"amount\": 50000\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Update the payment confirmation method", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/direct-debit/edit-confirm-payment-method", "host": [ "{{baseUrl}}" ], "path": [ "v1", "direct-debit", "edit-confirm-payment-method" ] }, "description": "Create a request to change the payment confirmation method (Email/Zalo). Returns a URL where the customer completes the configuration.\n\nDocumentation: https://developers.tingee.vn/en/docs/direct-debit/edit-confirm-payment-method", "body": { "mode": "raw", "raw": "{\n \"requestId\": \"550760e0-1cc2-44b9-85ba-eb318e228b4f\",\n \"subscriptionId\": \"89188e53-eba3-40fa-9323-04422ced3637\",\n \"returnUrl\": \"https://example.com\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Query account status", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/direct-debit/get-subscription-status?requestId=550760e0-1cc2-44b9-85ba-eb318e228b4f&subscriptionId=89188e53-eba3-40fa-9323-04422ced3637&tokenRef=TKN-12345678", "host": [ "{{baseUrl}}" ], "path": [ "v1", "direct-debit", "get-subscription-status" ], "query": [ { "key": "requestId", "value": "550760e0-1cc2-44b9-85ba-eb318e228b4f" }, { "key": "subscriptionId", "value": "89188e53-eba3-40fa-9323-04422ced3637" }, { "key": "tokenRef", "value": "TKN-12345678" } ] }, "description": "Get the details and current status (active/inactive) of a linked account.\n\nDocumentation: https://developers.tingee.vn/en/docs/direct-debit/get-subscription-status" }, "response": [] }, { "name": "Query transaction status", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/direct-debit/get-transaction-status?transactionId=550760e0-1cc2-44b9-85ba-eb318e228b4f&subscriptionId=89188e53-eba3-40fa-9323-04422ced3637&tokenRef=TKN-12345678", "host": [ "{{baseUrl}}" ], "path": [ "v1", "direct-debit", "get-transaction-status" ], "query": [ { "key": "transactionId", "value": "550760e0-1cc2-44b9-85ba-eb318e228b4f" }, { "key": "subscriptionId", "value": "89188e53-eba3-40fa-9323-04422ced3637" }, { "key": "tokenRef", "value": "TKN-12345678" } ] }, "description": "Get the detailed status of a specific transaction by transactionId (the transaction ID on the TINGEE system).\n\nDocumentation: https://developers.tingee.vn/en/docs/direct-debit/get-transaction-status" }, "response": [] }, { "name": "Query transaction history", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/direct-debit/get-paging-transactions?subscriptionId=89188e53-eba3-40fa-9323-04422ced3637&tokenRef=TKN-12345678&startTime=2025-12-16 12:20:49&endTime=2026-01-15 12:20:49&skipCount=0&maxResultCount=10", "host": [ "{{baseUrl}}" ], "path": [ "v1", "direct-debit", "get-paging-transactions" ], "query": [ { "key": "subscriptionId", "value": "89188e53-eba3-40fa-9323-04422ced3637" }, { "key": "tokenRef", "value": "TKN-12345678" }, { "key": "startTime", "value": "2025-12-16 12:20:49" }, { "key": "endTime", "value": "2026-01-15 12:20:49" }, { "key": "skipCount", "value": "0" }, { "key": "maxResultCount", "value": "10" } ] }, "description": "Get the list of completed payment transactions, with time filtering and pagination.\n\nDocumentation: https://developers.tingee.vn/en/docs/direct-debit/get-paging-transactions" }, "response": [] } ] } ] }, { "name": "Disbursement", "item": [ { "name": "API Reference", "item": [ { "name": "Maker/Checker flow", "item": [ { "name": "Get authorization URL", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/direct-link/get-authorization-url?bankBin=970418&role=Maker&returnUrl=https://yourdomain.com/callback", "host": [ "{{baseUrl}}" ], "path": [ "v1", "direct-link", "get-authorization-url" ], "query": [ { "key": "bankBin", "value": "970418" }, { "key": "role", "value": "Maker" }, { "key": "returnUrl", "value": "https://yourdomain.com/callback" } ] }, "description": "Get the account authorization URL (BIDV only)\n\nDocumentation: https://developers.tingee.vn/en/docs/direct-link/get-authorization-url" }, "response": [] }, { "name": "Create payment order — INIT (Single)", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/direct-link/create-transfer", "host": [ "{{baseUrl}}" ], "path": [ "v1", "direct-link", "create-transfer" ] }, "description": "Create a disbursement payment order using the Maker/Checker model (BIDV only)\n\nDocumentation: https://developers.tingee.vn/en/docs/direct-link/create-transfer-maker-checker", "body": { "mode": "raw", "raw": "{\n \"actionType\": \"INTERNAL_TRANSFER\",\n \"action\": \"INIT\",\n \"bankBin\": \"970418\",\n \"debitAccountNumber\": \"8600007007\",\n \"currency\": \"VND\",\n \"feeMethod\": \"O\",\n \"effectiveDate\": \"2026-06-04\",\n \"records\": [\n {\n \"requestId\": \"TRANS_1006_A04\",\n \"creditAccountType\": \"ACCOUNT\",\n \"creditAccountNumber\": \"2220366666\",\n \"creditAccountName\": \"NGUYEN VAN A\",\n \"amount\": 32987,\n \"creditBankBin\": \"970418\",\n \"remark\": \"Chuyen tien\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Create payment order — INIT (Batch)", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/direct-link/create-transfer", "host": [ "{{baseUrl}}" ], "path": [ "v1", "direct-link", "create-transfer" ] }, "description": "Create a disbursement payment order using the Maker/Checker model (BIDV only)\n\nDocumentation: https://developers.tingee.vn/en/docs/direct-link/create-transfer-maker-checker", "body": { "mode": "raw", "raw": "{\n \"actionType\": \"INTERNAL_TRANSFER\",\n \"action\": \"INIT\",\n \"bankBin\": \"970418\",\n \"debitAccountNumber\": \"8600007007\",\n \"currency\": \"VND\",\n \"feeMethod\": \"O\",\n \"effectiveDate\": \"2026-06-04\",\n \"remark\": \"Chuyen tien nhieu nguoi\",\n \"records\": [\n {\n \"requestId\": \"TRANS_0406_A04\",\n \"creditAccountType\": \"ACCOUNT\",\n \"creditAccountNumber\": \"2220366666\",\n \"creditAccountName\": \"NGUYEN VAN A\",\n \"amount\": 32987,\n \"creditBankBin\": \"970418\",\n \"transactionType\": \"in-bank\",\n \"remark\": \"Thanh toan 1\"\n },\n {\n \"requestId\": \"TRANS_0406_A05\",\n \"creditAccountType\": \"ACCOUNT\",\n \"creditAccountNumber\": \"6666688822\",\n \"creditAccountName\": \"NGUYEN LOC PHAT\",\n \"amount\": 12098,\n \"creditBankBin\": \"970406\",\n \"transactionType\": \"fast-out\",\n \"remark\": \"Thanh toan 2\"\n },\n {\n \"requestId\": \"TRANS_0406_A06\",\n \"creditId\": \"034201000243\",\n \"creditAccountType\": \"ID\",\n \"creditAccountName\": \"TRAN NHAT LE\",\n \"amount\": 32987,\n \"creditBankBin\": \"970406\",\n \"transactionType\": \"fast-out\",\n \"creditIssueDate\": \"2022-06-02\",\n \"creditIssueAddress\": \"Ha Noi\",\n \"creditBranchCode\": \"96304004\",\n \"remark\": \"Thanh toan 3\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Create payment order — REQUEST_APPROVAL (Single)", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/direct-link/create-transfer", "host": [ "{{baseUrl}}" ], "path": [ "v1", "direct-link", "create-transfer" ] }, "description": "Create a disbursement payment order using the Maker/Checker model (BIDV only)\n\nDocumentation: https://developers.tingee.vn/en/docs/direct-link/create-transfer-maker-checker", "body": { "mode": "raw", "raw": "{\n \"actionType\": \"INTERNAL_TRANSFER\",\n \"action\": \"REQUEST_APPROVAL\",\n \"bankBin\": \"970418\",\n \"debitAccountNumber\": \"8600007007\",\n \"currency\": \"VND\",\n \"feeMethod\": \"O\",\n \"approvalNote\": \"Duyet gap\",\n \"effectiveDate\": \"2026-06-04\",\n \"records\": [\n {\n \"requestId\": \"TRANS_1006_A04\",\n \"creditAccountType\": \"ACCOUNT\",\n \"creditAccountNumber\": \"2220366666\",\n \"creditAccountName\": \"NGUYEN VAN A\",\n \"amount\": 32987,\n \"creditBankBin\": \"970418\",\n \"remark\": \"Chuyen tien\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Create payment order — REQUEST_APPROVAL (Batch)", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/direct-link/create-transfer", "host": [ "{{baseUrl}}" ], "path": [ "v1", "direct-link", "create-transfer" ] }, "description": "Create a disbursement payment order using the Maker/Checker model (BIDV only)\n\nDocumentation: https://developers.tingee.vn/en/docs/direct-link/create-transfer-maker-checker", "body": { "mode": "raw", "raw": "{\n \"actionType\": \"INTERNAL_TRANSFER\",\n \"action\": \"REQUEST_APPROVAL\",\n \"bankBin\": \"970418\",\n \"debitAccountNumber\": \"8600007007\",\n \"currency\": \"VND\",\n \"feeMethod\": \"O\",\n \"approvalNote\": \"Duyet gap\",\n \"effectiveDate\": \"2026-06-04\",\n \"remark\": \"Chuyen tien nhieu nguoi\",\n \"records\": [\n {\n \"requestId\": \"TRANS_0406_A04\",\n \"creditAccountType\": \"ACCOUNT\",\n \"creditAccountNumber\": \"2220366666\",\n \"creditAccountName\": \"NGUYEN VAN A\",\n \"amount\": 32987,\n \"creditBankBin\": \"970418\",\n \"transactionType\": \"in-bank\",\n \"remark\": \"Thanh toan 1\"\n },\n {\n \"requestId\": \"TRANS_0406_A05\",\n \"creditAccountType\": \"ACCOUNT\",\n \"creditAccountNumber\": \"6666688822\",\n \"creditAccountName\": \"NGUYEN LOC PHAT\",\n \"amount\": 12098,\n \"creditBankBin\": \"970406\",\n \"transactionType\": \"fast-out\",\n \"remark\": \"Thanh toan 2\"\n },\n {\n \"requestId\": \"TRANS_0406_A06\",\n \"creditId\": \"034201000243\",\n \"creditAccountType\": \"ID\",\n \"creditAccountName\": \"TRAN NHAT LE\",\n \"amount\": 32987,\n \"creditBankBin\": \"970406\",\n \"transactionType\": \"fast-out\",\n \"creditIssueDate\": \"2022-06-02\",\n \"creditIssueAddress\": \"Ha Noi\",\n \"creditBranchCode\": \"96304004\",\n \"remark\": \"Thanh toan 3\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Delete payment order", "request": { "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/direct-link/delete-transfer", "host": [ "{{baseUrl}}" ], "path": [ "v1", "direct-link", "delete-transfer" ] }, "description": "Delete a disbursement payment order you created (Maker)\n\nDocumentation: https://developers.tingee.vn/en/docs/direct-link/delete-transfer", "body": { "mode": "raw", "raw": "{\n \"bankBin\": \"970418\",\n \"actionType\": \"INTERNAL_TRANSFER\",\n \"ids\": [\n \"PM0226061000074420\"\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Submit a saved disbursement order for approval", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/direct-link/process-transaction", "host": [ "{{baseUrl}}" ], "path": [ "v1", "direct-link", "process-transaction" ] }, "description": "Submit a saved disbursement order for approval\n\nDocumentation: https://developers.tingee.vn/en/docs/direct-link/process-transaction", "body": { "mode": "raw", "raw": "{\n \"bankBin\": \"970418\",\n \"actionType\": \"INTERNAL_TRANSFER\",\n \"transactionIds\": [\n \"PM0226061000074420\"\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Confirm payment order", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/direct-link/confirm-transfer", "host": [ "{{baseUrl}}" ], "path": [ "v1", "direct-link", "confirm-transfer" ] }, "description": "Authenticate and complete the approval request for a disbursement payment order you created\n\nDocumentation: https://developers.tingee.vn/en/docs/direct-link/confirm-transfer", "body": { "mode": "raw", "raw": "{\n \"bankBin\": \"970418\",\n \"actionType\": \"INTERNAL_TRANSFER\",\n \"confirmId\": \"TXNKEY_INIT_PM13_25607354makerotv_2827594e-037d-434b-b534-b1ff52adad4a\",\n \"otp\": \"123456\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Approve payment order", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/direct-link/approve-transfer", "host": [ "{{baseUrl}}" ], "path": [ "v1", "direct-link", "approve-transfer" ] }, "description": "Approve a disbursement payment order (Checker)\n\nDocumentation: https://developers.tingee.vn/en/docs/direct-link/approve-transfer", "body": { "mode": "raw", "raw": "{\n \"bankBin\": \"970418\",\n \"actionType\": \"INTERNAL_TRANSFER\",\n \"transactionIds\": [\n \"PM0226061000074420\"\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Confirm disbursement approval", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/direct-link/approve-confirm", "host": [ "{{baseUrl}}" ], "path": [ "v1", "direct-link", "approve-confirm" ] }, "description": "Confirm the approval of a disbursement payment order (Checker)\n\nDocumentation: https://developers.tingee.vn/en/docs/direct-link/approve-confirm", "body": { "mode": "raw", "raw": "{\n \"bankBin\": \"970418\",\n \"actionType\": \"INTERNAL_TRANSFER\",\n \"confirmId\": \"TXNKEY_APPROVAL_25607354makerotv_a8993883-d5fe-4ced-a0c0-20cff5b5120b\",\n \"otp\": \"12345678\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Reject a disbursement order", "request": { "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/direct-link/reject-transaction", "host": [ "{{baseUrl}}" ], "path": [ "v1", "direct-link", "reject-transaction" ] }, "description": "Reject approval of a disbursement order (Checker)\n\nDocumentation: https://developers.tingee.vn/en/docs/direct-link/reject-transaction", "body": { "mode": "raw", "raw": "{\n \"bankBin\": \"970418\",\n \"actionType\": \"INTERNAL_TRANSFER\",\n \"transactionIds\": [\n \"PM0226061000074420\"\n ],\n \"rejectReason\": \"Thông tin không chính xác\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Query transaction list/details (BIDV) — BATCH_UPLOAD_INQUIRY", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/direct-link/transaction-inquiry", "host": [ "{{baseUrl}}" ], "path": [ "v1", "direct-link", "transaction-inquiry" ] }, "description": "Query the list and details of transactions in the Maker/Checker flow (BIDV).\n\nDocumentation: https://developers.tingee.vn/en/docs/direct-link/transaction-inquiry-maker-checker", "body": { "mode": "raw", "raw": "{\n \"bankBin\": \"970418\",\n \"actionType\": \"INTERNAL_TRANSFER\",\n \"inquiryType\": \"BATCH_UPLOAD_INQUIRY\",\n \"role\": \"Maker\",\n \"batchId\": \"2667c208-a5ab-4c9c-af4d-cbd4de24b817\",\n \"status\": \"VALID\",\n \"skipCount\": 0,\n \"maxResultCount\": 50\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Query transaction list/details (BIDV) — PENDING_APPROVAL_LIST", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/direct-link/transaction-inquiry", "host": [ "{{baseUrl}}" ], "path": [ "v1", "direct-link", "transaction-inquiry" ] }, "description": "Query the list and details of transactions in the Maker/Checker flow (BIDV).\n\nDocumentation: https://developers.tingee.vn/en/docs/direct-link/transaction-inquiry-maker-checker", "body": { "mode": "raw", "raw": "{\n \"bankBin\": \"970418\",\n \"actionType\": \"INTERNAL_TRANSFER\",\n \"inquiryType\": \"PENDING_APPROVAL_LIST\",\n \"role\": \"Checker\",\n \"skipCount\": 0,\n \"maxResultCount\": 3\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Query transaction list/details (BIDV) — MAKER_PENDING_LIST", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/direct-link/transaction-inquiry", "host": [ "{{baseUrl}}" ], "path": [ "v1", "direct-link", "transaction-inquiry" ] }, "description": "Query the list and details of transactions in the Maker/Checker flow (BIDV).\n\nDocumentation: https://developers.tingee.vn/en/docs/direct-link/transaction-inquiry-maker-checker", "body": { "mode": "raw", "raw": "{\n \"bankBin\": \"970418\",\n \"actionType\": \"INTERNAL_TRANSFER\",\n \"inquiryType\": \"MAKER_PENDING_LIST\",\n \"role\": \"Maker\",\n \"skipCount\": 0,\n \"maxResultCount\": 3\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Query transaction list/details (BIDV) — TRANSFER_DETAIL", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/direct-link/transaction-inquiry", "host": [ "{{baseUrl}}" ], "path": [ "v1", "direct-link", "transaction-inquiry" ] }, "description": "Query the list and details of transactions in the Maker/Checker flow (BIDV).\n\nDocumentation: https://developers.tingee.vn/en/docs/direct-link/transaction-inquiry-maker-checker", "body": { "mode": "raw", "raw": "{\n \"bankBin\": \"970418\",\n \"actionType\": \"INTERNAL_TRANSFER\",\n \"inquiryType\": \"TRANSFER_DETAIL\",\n \"role\": \"Maker\",\n \"id\": \"PM0226060400073501\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Query transaction list/details (BIDV) — FO_REPORT_LIST", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/direct-link/transaction-inquiry", "host": [ "{{baseUrl}}" ], "path": [ "v1", "direct-link", "transaction-inquiry" ] }, "description": "Query the list and details of transactions in the Maker/Checker flow (BIDV).\n\nDocumentation: https://developers.tingee.vn/en/docs/direct-link/transaction-inquiry-maker-checker", "body": { "mode": "raw", "raw": "{\n \"bankBin\": \"970418\",\n \"actionType\": \"INTERNAL_TRANSFER\",\n \"inquiryType\": \"FO_REPORT_LIST\",\n \"role\": \"Maker\",\n \"startEffectiveDate\": \"2026-06-10\",\n \"endEffectiveDate\": \"2026-06-10\",\n \"skipCount\": 0,\n \"maxResultCount\": 3\n}", "options": { "raw": { "language": "json" } } } }, "response": [] } ] }, { "name": "Automatic disbursement flow", "item": [ { "name": "Create payment order — Single", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/direct-link/create-transfer", "host": [ "{{baseUrl}}" ], "path": [ "v1", "direct-link", "create-transfer" ] }, "description": "Create a straight-through disbursement payment order (for the VietinBank and BaoKim flows)\n\nDocumentation: https://developers.tingee.vn/en/docs/direct-link/create-transfer-direct", "body": { "mode": "raw", "raw": "{\n \"bankBin\": \"970415\",\n \"debitAccountNumber\": \"117000107563\",\n \"debitAccountName\": \"Customer Title 1\",\n \"transactionType\": \"in-bank\",\n \"feeMethod\": \"O\",\n \"records\": [\n {\n \"requestId\": \"TRANS_0611_A03\",\n \"creditAccountNumber\": \"103000614434\",\n \"creditAccountName\": \"CUSTOMER TITLE 1\",\n \"amount\": 100000,\n \"creditBankBin\": \"970415\",\n \"remark\": \"thanh toán\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Create payment order — Batch", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/direct-link/create-transfer", "host": [ "{{baseUrl}}" ], "path": [ "v1", "direct-link", "create-transfer" ] }, "description": "Create a straight-through disbursement payment order (for the VietinBank and BaoKim flows)\n\nDocumentation: https://developers.tingee.vn/en/docs/direct-link/create-transfer-direct", "body": { "mode": "raw", "raw": "{\n \"bankBin\": \"970415\",\n \"debitAccountNumber\": \"117000107563\",\n \"debitAccountName\": \"Customer Title 1\",\n \"transactionType\": \"in-bank\",\n \"feeMethod\": \"O\",\n \"records\": [\n {\n \"requestId\": \"TRANS_0611_A01\",\n \"creditAccountNumber\": \"103000614434\",\n \"creditAccountName\": \"CUSTOMER TITLE 1\",\n \"amount\": 100000,\n \"creditBankBin\": \"970415\",\n \"remark\": \"thanh toán\"\n },\n {\n \"requestId\": \"TRANS_0611_A02\",\n \"creditAccountNumber\": \"115000070017\",\n \"creditAccountName\": \"Cty Huyen Trang Sua ten\",\n \"amount\": 100000,\n \"creditBankBin\": \"970415\",\n \"remark\": \"thanh toán\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Create payment order — BaoKim (Single)", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/direct-link/create-transfer", "host": [ "{{baseUrl}}" ], "path": [ "v1", "direct-link", "create-transfer" ] }, "description": "Create a straight-through disbursement payment order (for the VietinBank and BaoKim flows)\n\nDocumentation: https://developers.tingee.vn/en/docs/direct-link/create-transfer-direct", "body": { "mode": "raw", "raw": "{\n \"bankBin\": \"BAOKIM\",\n \"currency\": \"VND\",\n \"debitAccountNumber\": \"84850000108\",\n \"records\": [\n {\n \"requestId\": \"REQ31012\",\n \"amount\": 55666,\n \"creditAccountNumber\": \"100100132450\",\n \"creditBankBin\": \"970432\",\n \"creditAccountType\": \"ACCOUNT\",\n \"remark\": \"test rút tiền về ví\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Query transaction list/details (VietinBank, BaoKim) — VietinBank", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/direct-link/transaction-inquiry", "host": [ "{{baseUrl}}" ], "path": [ "v1", "direct-link", "transaction-inquiry" ] }, "description": "Query the processing status of disbursement transactions in the automatic disbursement flow (VietinBank, BaoKim).\n\nDocumentation: https://developers.tingee.vn/en/docs/direct-link/transaction-inquiry-direct", "body": { "mode": "raw", "raw": "{\n \"bankBin\": \"970415\",\n \"batchId\": \"7CB875795D6B2F3374D3B489B09CAA92\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Query transaction list/details (VietinBank, BaoKim) — BaoKim (TRANSFER_DETAIL)", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/direct-link/transaction-inquiry", "host": [ "{{baseUrl}}" ], "path": [ "v1", "direct-link", "transaction-inquiry" ] }, "description": "Query the processing status of disbursement transactions in the automatic disbursement flow (VietinBank, BaoKim).\n\nDocumentation: https://developers.tingee.vn/en/docs/direct-link/transaction-inquiry-direct", "body": { "mode": "raw", "raw": "{\n \"bankBin\": \"BAOKIM\",\n \"inquiryType\": \"TRANSFER_DETAIL\",\n \"transactionId\": \"REQ31012\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Query transaction list/details (VietinBank, BaoKim) — BaoKim (BATCH_DETAIL)", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/direct-link/transaction-inquiry", "host": [ "{{baseUrl}}" ], "path": [ "v1", "direct-link", "transaction-inquiry" ] }, "description": "Query the processing status of disbursement transactions in the automatic disbursement flow (VietinBank, BaoKim).\n\nDocumentation: https://developers.tingee.vn/en/docs/direct-link/transaction-inquiry-direct", "body": { "mode": "raw", "raw": "{\n \"bankBin\": \"BAOKIM\",\n \"inquiryType\": \"BATCH_DETAIL\",\n \"batchId\": \"eb3c9bb6-1c4c-4245-87c7-2d3640f72558\",\n \"status\": \"SUCCESS\",\n \"skipCount\": 0,\n \"maxResultCount\": 10\n}", "options": { "raw": { "language": "json" } } } }, "response": [] } ] }, { "name": "Lookups & Utilities", "item": [ { "name": "Query the action history of a transaction", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/direct-link/financial-utility/transaction-log-inquiry?bankBin=970418&transactionCode=PM02&transactionId=TRANS_001&role=Maker", "host": [ "{{baseUrl}}" ], "path": [ "v1", "direct-link", "financial-utility", "transaction-log-inquiry" ], "query": [ { "key": "bankBin", "value": "970418" }, { "key": "transactionCode", "value": "PM02" }, { "key": "transactionId", "value": "TRANS_001" }, { "key": "role", "value": "Maker" } ] }, "description": "Lets partners query the action history of a specific transaction by ID (including actions such as submit for approval, approve, reject... and processing by the bank)\n\nDocumentation: https://developers.tingee.vn/en/docs/direct-link/transaction-log-inquiry" }, "response": [] }, { "name": "Get recipient banks", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/direct-link/financial-utility/get-domestic-bank-list?listTypeTransfer=1&bankBin=970418&role=Maker", "host": [ "{{baseUrl}}" ], "path": [ "v1", "direct-link", "financial-utility", "get-domestic-bank-list" ], "query": [ { "key": "listTypeTransfer", "value": "1" }, { "key": "bankBin", "value": "970418" }, { "key": "role", "value": "Maker" } ] }, "description": "Get the list of recipient banks used when creating disbursement payment orders\n\nDocumentation: https://developers.tingee.vn/en/docs/direct-link/get-domestic-bank-list" }, "response": [] }, { "name": "Get bank branches", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/direct-link/bank-branches?bankBin=970418", "host": [ "{{baseUrl}}" ], "path": [ "v1", "direct-link", "bank-branches" ], "query": [ { "key": "bankBin", "value": "970418" } ] }, "description": "List of recipient bank branches used when creating disbursement payment orders\n\nDocumentation: https://developers.tingee.vn/en/docs/direct-link/bank-branches" }, "response": [] }, { "name": "Export transaction results to Excel", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/direct-link/batch-result-download?batchId=YOUR_BATCH_ID&bankBin=970418", "host": [ "{{baseUrl}}" ], "path": [ "v1", "direct-link", "batch-result-download" ], "query": [ { "key": "batchId", "value": "YOUR_BATCH_ID" }, { "key": "bankBin", "value": "970418" } ] }, "description": "Download the batch processing result file\n\nDocumentation: https://developers.tingee.vn/en/docs/direct-link/batch-result-download" }, "response": [] }, { "name": "Beneficiary inquiry (BIDV, VietinBank, BaoKim)", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/direct-link/financial-utility/account-inquiry?bankBin=970418&role=Maker&creditBankBin=970418&creditAccountNumber=1234567890", "host": [ "{{baseUrl}}" ], "path": [ "v1", "direct-link", "financial-utility", "account-inquiry" ], "query": [ { "key": "bankBin", "value": "970418" }, { "key": "role", "value": "Maker" }, { "key": "creditBankBin", "value": "970418" }, { "key": "creditAccountNumber", "value": "1234567890" } ] }, "description": "Look up the beneficiary account information\n\nDocumentation: https://developers.tingee.vn/en/docs/direct-link/account-inquiry" }, "response": [] }, { "name": "Get financial account details", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/direct-link/financial-utility/account-balance-detail?bankBin=970418&role=Maker&accountNumber=1234567890", "host": [ "{{baseUrl}}" ], "path": [ "v1", "direct-link", "financial-utility", "account-balance-detail" ], "query": [ { "key": "bankBin", "value": "970418" }, { "key": "role", "value": "Maker" }, { "key": "accountNumber", "value": "1234567890" } ] }, "description": "Account balance details\n\nDocumentation: https://developers.tingee.vn/en/docs/direct-link/account-balance-detail" }, "response": [] }, { "name": "Check fee account information", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/direct-link/financial-utility/validate-charge-account", "host": [ "{{baseUrl}}" ], "path": [ "v1", "direct-link", "financial-utility", "validate-charge-account" ] }, "description": "Validate the fee account\n\nDocumentation: https://developers.tingee.vn/en/docs/direct-link/validate-charge-account", "body": { "mode": "raw", "raw": "{\n \"bankBin\": \"970418\",\n \"accountNumber\": \"1234567890\",\n \"cif\": \"12345678\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Payment account details", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/direct-link/account-statement/payment-account-detail?bankBin=970418&role=Maker&accountNumber=1234567890", "host": [ "{{baseUrl}}" ], "path": [ "v1", "direct-link", "account-statement", "payment-account-detail" ], "query": [ { "key": "bankBin", "value": "970418" }, { "key": "role", "value": "Maker" }, { "key": "accountNumber", "value": "1234567890" } ] }, "description": "Query the information and balance of a payment account (BIDV, VietinBank)\n\nDocumentation: https://developers.tingee.vn/en/docs/direct-link/payment-detail" }, "response": [] }, { "name": "Payment account transaction history", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/direct-link/account-statement/payment-transaction-history?bankBin=970418&role=Maker&accountNumber=1234567890&startDate=2025-11-01&endDate=2025-11-10", "host": [ "{{baseUrl}}" ], "path": [ "v1", "direct-link", "account-statement", "payment-transaction-history" ], "query": [ { "key": "bankBin", "value": "970418" }, { "key": "role", "value": "Maker" }, { "key": "accountNumber", "value": "1234567890" }, { "key": "startDate", "value": "2025-11-01" }, { "key": "endDate", "value": "2025-11-10" } ] }, "description": "Payment transaction history\n\nDocumentation: https://developers.tingee.vn/en/docs/direct-link/payment-transaction-history" }, "response": [] } ] } ] } ] }, { "name": "Devices & Hardware", "item": [ { "name": "Have the device read out its security code (Read Security Code)", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/device/read-security-code", "host": [ "{{baseUrl}}" ], "path": [ "v1", "device", "read-security-code" ] }, "description": "Send a command so that the TINGEEBOX device (identified by UUID) reads its security code aloud, for the step that links the device to a shop.\n\nDocumentation: https://developers.tingee.vn/en/docs/tingee-box/read-security-code", "body": { "mode": "raw", "raw": "{\n \"uuid\": \"DEVICE-001\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Read an amount aloud on the device", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/device/read-amount-link-to-merchant", "host": [ "{{baseUrl}}" ], "path": [ "v1", "device", "read-amount-link-to-merchant" ] }, "description": "Send a command to the TingeeBox device to read out the amount.\n\nDocumentation: https://developers.tingee.vn/en/docs/tingee-box/read-amount", "body": { "mode": "raw", "raw": "{\n \"uuid\": \"DEVICE-001\",\n \"transactionId\": \"TX123456\",\n \"amount\": 150000,\n \"bankBin\": \"970422\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Print a receipt from the device", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/device/print-receipt", "host": [ "{{baseUrl}}" ], "path": [ "v1", "device", "print-receipt" ] }, "description": "Send a print receipt command to a Tingee Box MAX device.\n\nDocumentation: https://developers.tingee.vn/en/docs/tingee-box/print-receipt", "body": { "mode": "raw", "raw": "{\n \"uuid\": \"DEVICE-001\",\n \"copies\": 1,\n \"storeName\": \"Cửa hàng tiện lợi\",\n \"orderCode\": \"DH123456\",\n \"totalAmount\": 150000,\n \"items\": [\n {\n \"name\": \"Sản phẩm A\",\n \"quantity\": 1,\n \"unitPrice\": 100000\n },\n {\n \"name\": \"Sản phẩm B\",\n \"quantity\": 1,\n \"unitPrice\": 50000\n }\n ],\n \"voiceFile\": 6\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Show QR Code", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/device/show-dynamic-qr-code", "host": [ "{{baseUrl}}" ], "path": [ "v1", "device", "show-dynamic-qr-code" ] }, "description": "Send a dynamic QR code to the TINGEEBOX device to show to customers.\n\nDocumentation: https://developers.tingee.vn/en/docs/tingee-box/show-qr-code", "body": { "mode": "raw", "raw": "{\n \"vaAccountNumber\": \"V1T123456789\",\n \"amount\": 150000,\n \"qrCode\": \"00020101021138580010A000000727...\",\n \"bankBin\": \"970422\",\n \"deviceType\": \"tingee-box-3ls\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Show QR Code", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/device/show-static-qr-code", "host": [ "{{baseUrl}}" ], "path": [ "v1", "device", "show-static-qr-code" ] }, "description": "Send a static QR code to the TINGEEBOX device to show to customers.\n\nDocumentation: https://developers.tingee.vn/en/docs/tingee-box/show-qr-code", "body": { "mode": "raw", "raw": "{\n \"vaAccountNumber\": \"V1T123456789\",\n \"amount\": 150000,\n \"qrCode\": \"00020101021138580010A00000072701240006970422011001234567890208QRIBFTTA5204541153037045802VN62180814Thanh toan don6304CA68\",\n \"bankBin\": \"970422\",\n \"deviceType\": \"tingee-box-3ls\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Create and show QR", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/device/generate-and-show-dynamic-qr-code", "host": [ "{{baseUrl}}" ], "path": [ "v1", "device", "generate-and-show-dynamic-qr-code" ] }, "description": "Create a dynamic QR Code and show it on the TINGEEBOX device right away for customers to scan and pay.\n\nDocumentation: https://developers.tingee.vn/en/docs/tingee-box/generate-and-show-dynamic-qr-code", "body": { "mode": "raw", "raw": "{\n \"uuid\": \"DEVICE_UUID\",\n \"qrCodeType\": \"dynamic-one-time-payment\",\n \"vaAccountNumber\": \"V1T123456789\",\n \"amount\": 150000,\n \"purpose\": \"Thanh toan don hang #001\",\n \"bankBin\": \"970422\",\n \"expireInMinute\": 5,\n \"firstText\": \"Quan ABC\",\n \"showTime\": 30,\n \"playSound\": true,\n \"readAmountAfterPay\": true\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Add a device to a shop (Add Device To Shop)", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/device/add-device-to-shop", "host": [ "{{baseUrl}}" ], "path": [ "v1", "device", "add-device-to-shop" ] }, "description": "Link a new TINGEEBOX device to the Merchant's management system.\n\nDocumentation: https://developers.tingee.vn/en/docs/tingee-box/add-device-to-shop", "body": { "mode": "raw", "raw": "{\n \"uuid\": \"DEVICE-001\",\n \"securityCode\": \"ABC123XYZ\",\n \"shopIds\": [\n 12\n ],\n \"appType\": \"ocb-web\",\n \"vaAccountNumbers\": [\n \"123456789\"\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Update the device-to-shop link status", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/device/update-shop-device-link-status", "host": [ "{{baseUrl}}" ], "path": [ "v1", "device", "update-shop-device-link-status" ] }, "description": "Update the list of shops whose transactions the TINGEEBOX device is allowed to show.\n\nDocumentation: https://developers.tingee.vn/en/docs/tingee-box/update-shop-device-link-status", "body": { "mode": "raw", "raw": "{\n \"uuid\": \"DEVICE-001\",\n \"type\": \"app-tingee\",\n \"appType\": \"ocb-web\",\n \"shopsLinkToDeviceDtos\": [\n {\n \"shopName\": \"Shop Demo\",\n \"shopId\": 101,\n \"isLinkToDevice\": true,\n \"fullAddress\": \"123 Main St\",\n \"vaAccountNumber\": \"123456789\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "List devices", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/device/get-paging", "host": [ "{{baseUrl}}" ], "path": [ "v1", "device", "get-paging" ] }, "description": "Query a Merchant's devices with full details.\n\nDocumentation: https://developers.tingee.vn/en/docs/tingee-box/get-paging", "body": { "mode": "raw", "raw": "{\n \"skipCount\": 0,\n \"maxResultCount\": 10,\n \"merchantId\": 123456\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "List devices linked to a shop or VA", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/device/get-devices-link-to-shop-or-va", "host": [ "{{baseUrl}}" ], "path": [ "v1", "device", "get-devices-link-to-shop-or-va" ] }, "description": "Query the list of devices by shopId or vaAccountNumber.\n\nDocumentation: https://developers.tingee.vn/en/docs/tingee-box/get-devices-link-to-shop-or-va", "body": { "mode": "raw", "raw": "{\n \"vaAccountNumber\": \"V1THENO84343344\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] } ] }, { "name": "Operations & Extensions", "item": [ { "name": "Master Merchant", "item": [ { "name": "Merchant", "item": [ { "name": "Create a Merchant account", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/merchant/create", "host": [ "{{baseUrl}}" ], "path": [ "v1", "merchant", "create" ] }, "description": "Create a new Merchant entity to start integrating Tingee's payment services.\n\nDocumentation: https://developers.tingee.vn/en/docs/master-merchant/merchant/create", "body": { "mode": "raw", "raw": "{\n \"name\": \"Doanh nghiệp Vận tải Miền trung\",\n \"phoneNumber\": \"0946881502\",\n \"email\": \"vantaimientrung@gmail.com\",\n \"website\": \"https://vtmt.com\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Get the Merchant list", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/merchant/get-paging", "host": [ "{{baseUrl}}" ], "path": [ "v1", "merchant", "get-paging" ] }, "description": "Get the list of sub-Merchants, filtered by keyword or status.\n\nDocumentation: https://developers.tingee.vn/en/docs/master-merchant/merchant/get-paging", "body": { "mode": "raw", "raw": "{\n \"filter\": \"\",\n \"skipCount\": 0,\n \"maxResultCount\": 10\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Delete a Merchant account", "request": { "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/merchant/delete?merchantId=12345", "host": [ "{{baseUrl}}" ], "path": [ "v1", "merchant", "delete" ], "query": [ { "key": "merchantId", "value": "12345" } ] }, "description": "Permanently delete a sub-Merchant from the Master Merchant's system.\n\nDocumentation: https://developers.tingee.vn/en/docs/master-merchant/merchant/delete" }, "response": [] } ] }, { "name": "Shops", "item": [ { "name": "Create/update a shop", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/shop/create-or-update", "host": [ "{{baseUrl}}" ], "path": [ "v1", "shop", "create-or-update" ] }, "description": "Add a new shop or update shop details, depending on the 'id' parameter.\n\nDocumentation: https://developers.tingee.vn/en/docs/master-merchant/shop/create-or-update", "body": { "mode": "raw", "raw": "{\n \"merchantId\": 10001,\n \"name\": \"Cửa hàng Chi nhánh 1\",\n \"isActive\": true,\n \"address\": \"Số 123 Đường ABC, Hà Nội\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Get the shop list", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/shop/get-paging", "host": [ "{{baseUrl}}" ], "path": [ "v1", "shop", "get-paging" ] }, "description": "Query the shop list with pagination and advanced filtering.\n\nDocumentation: https://developers.tingee.vn/en/docs/master-merchant/shop/get-paging", "body": { "mode": "raw", "raw": "{\n \"filter\": \"\",\n \"skipCount\": 0,\n \"maxResultCount\": 10,\n \"merchantId\": 1001\n}", "options": { "raw": { "language": "json" } } } }, "response": [] } ] }, { "name": "Devices", "item": [ { "name": "Reset a device", "request": { "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/device/reset?uuid=DEVICE_UUID", "host": [ "{{baseUrl}}" ], "path": [ "v1", "device", "reset" ], "query": [ { "key": "uuid", "value": "DEVICE_UUID" } ] }, "description": "Send a command that resets a TingeeBox device to its initial state and removes its link to the merchant.\n\nDocumentation: https://developers.tingee.vn/en/docs/master-merchant/device/reset-device" }, "response": [] } ] } ] }, { "name": "Webhook (IPN)", "item": [ { "name": "Payment webhook (QR Code & dynamic QR)", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/webhook/payment", "host": [ "{{baseUrl}}" ], "path": [ "api", "webhook", "payment" ] }, "description": "Push notification of transaction data from Tingee to your system as soon as money arrives in the account.\n\nDocumentation: https://developers.tingee.vn/en/docs/webhook/webhook-payment-callback" }, "response": [] }, { "name": "Account linking status webhook", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/webhook/va-status", "host": [ "{{baseUrl}}" ], "path": [ "api", "webhook", "va-status" ] }, "description": "Webhook that notifies the partner system of the virtual account linking or unlinking status from VCB and TPBank.\n\nDocumentation: https://developers.tingee.vn/en/docs/webhook/webhook-va-status" }, "response": [] }, { "name": "Bank link webhook (Bank Link)", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/webhook/bank-link", "host": [ "{{baseUrl}}" ], "path": [ "api", "webhook", "bank-link" ] }, "description": "Notification that syncs the successfully linked bank account information from Tingee to the partner system.\n\nDocumentation: https://developers.tingee.vn/en/docs/webhook/webhook-bank-link" }, "response": [] } ] }, { "name": "Business account configuration", "item": [ { "name": "Get the bank configuration list", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/merchant/get-paging-config", "host": [ "{{baseUrl}}" ], "path": [ "v1", "merchant", "get-paging-config" ] }, "description": "Query a Merchant's bank connection configurations by filter conditions.\n\nDocumentation: https://developers.tingee.vn/en/docs/cau-hinh-tai-khoan-dn/get-paging-config", "body": { "mode": "raw", "raw": "{\n \"bankBin\": \"970416\",\n \"skipCount\": 0,\n \"maxResultCount\": 10\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Create / update a bank configuration", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/merchant/create-or-update-config", "host": [ "{{baseUrl}}" ], "path": [ "v1", "merchant", "create-or-update-config" ] }, "description": "Create or update the bank integration configuration for a Merchant.\n\nDocumentation: https://developers.tingee.vn/en/docs/cau-hinh-tai-khoan-dn/create-or-update-config", "body": { "mode": "raw", "raw": "{\n \"bankBin\": \"970418\",\n \"accountType\": \"business-account\",\n \"bidvConfigDto\": {\n \"accountNumber\": \"1234567890\",\n \"accountName\": \"CONG TY TNHH ABC\",\n \"vaPrefix\": \"TINGEE\",\n \"bankPartnerId\": \"PARTNER_001\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Delete a bank configuration", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/merchant/delete-config", "host": [ "{{baseUrl}}" ], "path": [ "v1", "merchant", "delete-config" ] }, "description": "Delete a Merchant's bank integration configuration for the specified bank.\n\nDocumentation: https://developers.tingee.vn/en/docs/cau-hinh-tai-khoan-dn/delete-config", "body": { "mode": "raw", "raw": "{\n \"id\": 1\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "[ACB] Configure a business account", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/merchant/config-account-business", "host": [ "{{baseUrl}}" ], "path": [ "v1", "merchant", "config-account-business" ] }, "description": "Link a business bank account and generate a confirmation code (confirmId) to complete the configuration.\n\nDocumentation: https://developers.tingee.vn/en/docs/cau-hinh-tai-khoan-dn/config-account-business", "body": { "mode": "raw", "raw": "{\n \"bankBin\": \"970416\",\n \"vaPrefix\": \"TINGEE\",\n \"accountName\": \"CONG TY TNHH ABC\",\n \"accountNumber\": \"1234567890\",\n \"mobile\": \"0901234567\",\n \"acbUserId\": \"ACB_USER_001\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "[ACB] Delete a business account configuration", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/merchant/delete-config-account-business", "host": [ "{{baseUrl}}" ], "path": [ "v1", "merchant", "delete-config-account-business" ] }, "description": "Delete an ACB business account configuration for a Merchant.\n\nDocumentation: https://developers.tingee.vn/en/docs/cau-hinh-tai-khoan-dn/delete-config-account-business", "body": { "mode": "raw", "raw": "{\n \"bankBin\": \"970416\",\n \"accountType\": \"business-account\",\n \"configRemove\": {\n \"accountNumber\": \"1234567890\",\n \"accountName\": \"CONG TY TNHH ABC\",\n \"vaPrefix\": \"TINGEE\",\n \"mobile\": \"0901234567\",\n \"acbUserId\": \"ACB_USER_001\"\n }\n}", "options": { "raw": { "language": "json" } } } }, "response": [] } ] } ] }, { "name": "E-invoices", "item": [ { "name": "Providers & Accounts", "item": [ { "name": "List providers", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/e-invoice/get-provider", "host": [ "{{baseUrl}}" ], "path": [ "v1", "e-invoice", "get-provider" ] }, "description": "Get the list of supported e-invoice providers.\n\nDocumentation: https://developers.tingee.vn/en/docs/hoa-don-dien-tu/get-provider" }, "response": [] }, { "name": "List provider accounts", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/e-invoice/get-paging-account", "host": [ "{{baseUrl}}" ], "path": [ "v1", "e-invoice", "get-paging-account" ] }, "description": "Query the list of e-invoice provider accounts by filter conditions.\n\nDocumentation: https://developers.tingee.vn/en/docs/hoa-don-dien-tu/get-paging-account", "body": { "mode": "raw", "raw": "{\n \"skipCount\": 0,\n \"maxResultCount\": 10,\n \"provider\": \"x-cyber\",\n \"isActive\": true\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Create / Update a provider account", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/e-invoice/create-or-update-account", "host": [ "{{baseUrl}}" ], "path": [ "v1", "e-invoice", "create-or-update-account" ] }, "description": "Create or update an e-invoice provider account.\n\nDocumentation: https://developers.tingee.vn/en/docs/hoa-don-dien-tu/create-or-update-account", "body": { "mode": "raw", "raw": "{\n \"provider\": \"x-cyber\",\n \"taxCode\": \"0101234567\",\n \"username\": \"admin@company.vn\",\n \"password\": \"your_password\",\n \"isDefault\": true,\n \"isActive\": true\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Delete a provider account", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/e-invoice/delete-account", "host": [ "{{baseUrl}}" ], "path": [ "v1", "e-invoice", "delete-account" ] }, "description": "Delete an e-invoice provider account by ID.\n\nDocumentation: https://developers.tingee.vn/en/docs/hoa-don-dien-tu/delete-account", "body": { "mode": "raw", "raw": "{\n \"id\": 1\n}", "options": { "raw": { "language": "json" } } } }, "response": [] } ] }, { "name": "Invoices", "item": [ { "name": "Create a draft invoice", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/e-invoice/create", "host": [ "{{baseUrl}}" ], "path": [ "v1", "e-invoice", "create" ] }, "description": "Create a draft invoice (draft/preview) and return the Base64 PDF file.\n\nDocumentation: https://developers.tingee.vn/en/docs/hoa-don-dien-tu/create", "body": { "mode": "raw", "raw": "{\n \"invoicePattern\": \"1\",\n \"invoiceSeries\": \"C25TAB\",\n \"invoiceCode\": \"INV-20251209-001\",\n \"invoiceDate\": \"2025-12-09\",\n \"buyerName\": \"Nguyen Van A\",\n \"buyerLegalName\": \"CONG TY TNHH ABC\",\n \"buyerTaxCode\": \"0109876543\",\n \"buyerAddress\": \"123 Nguyen Hue, Quan 1, TP.HCM\",\n \"paymentMethod\": 2,\n \"paymentMethodName\": \"Chuyển khoản\",\n \"items\": [\n {\n \"itemName\": \"Dịch vụ thanh toán\",\n \"unitName\": \"Gói\",\n \"quantity\": \"1\",\n \"unitPrice\": \"1000000\",\n \"taxRateCode\": \"10\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Create and issue an invoice", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/e-invoice/create-and-issue", "host": [ "{{baseUrl}}" ], "path": [ "v1", "e-invoice", "create-and-issue" ] }, "description": "Create, sign and issue an invoice in a single step (HSM signing).\n\nDocumentation: https://developers.tingee.vn/en/docs/hoa-don-dien-tu/create-and-issue", "body": { "mode": "raw", "raw": "{\n \"invoicePattern\": \"1\",\n \"invoiceSeries\": \"C25TAB\",\n \"invoiceCode\": \"INV-20251209-002\",\n \"invoiceDate\": \"2025-12-09\",\n \"buyerName\": \"Nguyen Van A\",\n \"buyerLegalName\": \"CONG TY TNHH ABC\",\n \"buyerTaxCode\": \"0109876543\",\n \"buyerAddress\": \"123 Nguyen Hue, Quan 1, TP.HCM\",\n \"paymentMethod\": 2,\n \"paymentMethodName\": \"Chuyển khoản\",\n \"items\": [\n {\n \"itemName\": \"Dịch vụ thanh toán\",\n \"unitName\": \"Gói\",\n \"quantity\": \"1\",\n \"unitPrice\": \"1000000\",\n \"taxRateCode\": \"10\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Download an invoice", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/e-invoice/download", "host": [ "{{baseUrl}}" ], "path": [ "v1", "e-invoice", "download" ] }, "description": "Download an issued invoice as a Base64 PDF by invoice code.\n\nDocumentation: https://developers.tingee.vn/en/docs/hoa-don-dien-tu/download", "body": { "mode": "raw", "raw": "{\n \"invoiceCode\": \"INV-20251209-001\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Get invoice templates", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/e-invoice/invoice-templates", "host": [ "{{baseUrl}}" ], "path": [ "v1", "e-invoice", "invoice-templates" ] }, "description": "Get the list of invoice templates registered with the provider.\n\nDocumentation: https://developers.tingee.vn/en/docs/hoa-don-dien-tu/invoice-templates", "body": { "mode": "raw", "raw": "{\n \"invoiceNoToCheck\": 100\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Send an invoice by email", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/e-invoice/send-email", "host": [ "{{baseUrl}}" ], "path": [ "v1", "e-invoice", "send-email" ] }, "description": "Send an invoice to the buyer by email.\n\nDocumentation: https://developers.tingee.vn/en/docs/hoa-don-dien-tu/send-email", "body": { "mode": "raw", "raw": "{\n \"invoiceCode\": \"INV-20251209-001\",\n \"recipientEmail\": \"buyer@example.com\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] } ] }, { "name": "Purchase invoices", "item": [ { "name": "Connect a tax account", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/e-invoice/input/connect", "host": [ "{{baseUrl}}" ], "path": [ "v1", "e-invoice", "input", "connect" ] }, "description": "Connect a General Department of Taxation (TCT) account to an e-invoice account.\n\nDocumentation: https://developers.tingee.vn/en/docs/hoa-don-dien-tu/hoa-don-dau-vao/connect", "body": { "mode": "raw", "raw": "{\n \"tctUsername\": \"0101234567\",\n \"tctPassword\": \"YOUR_TCT_PASSWORD\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Disconnect a tax account", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/e-invoice/input/disconnect", "host": [ "{{baseUrl}}" ], "path": [ "v1", "e-invoice", "input", "disconnect" ] }, "description": "Disconnect a General Department of Taxation (TCT) account.\n\nDocumentation: https://developers.tingee.vn/en/docs/hoa-don-dien-tu/hoa-don-dau-vao/disconnect", "body": { "mode": "raw", "raw": "{\n \"accountId\": 1\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Sync purchase invoices", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/e-invoice/input/sync", "host": [ "{{baseUrl}}" ], "path": [ "v1", "e-invoice", "input", "sync" ] }, "description": "Sync purchase invoices from the General Department of Taxation for a time range.\n\nDocumentation: https://developers.tingee.vn/en/docs/hoa-don-dien-tu/hoa-don-dau-vao/sync", "body": { "mode": "raw", "raw": "{\n \"fromDate\": \"01/10/2026\",\n \"toDate\": \"10/10/2026\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "List purchase invoices", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/e-invoice/input/list", "host": [ "{{baseUrl}}" ], "path": [ "v1", "e-invoice", "input", "list" ] }, "description": "Get the list of purchase invoices with pagination and filters.\n\nDocumentation: https://developers.tingee.vn/en/docs/hoa-don-dien-tu/hoa-don-dau-vao/list", "body": { "mode": "raw", "raw": "{\n \"page\": 0,\n \"size\": 50,\n \"invoiceFromDate\": \"2026-10-01 00:00:00.000\",\n \"invoiceToDate\": \"2026-10-10 23:59:59.999\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Purchase invoice details", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/e-invoice/input/detail", "host": [ "{{baseUrl}}" ], "path": [ "v1", "e-invoice", "input", "detail" ] }, "description": "Get the details of a purchase invoice by invoiceCode.\n\nDocumentation: https://developers.tingee.vn/en/docs/hoa-don-dien-tu/hoa-don-dau-vao/detail", "body": { "mode": "raw", "raw": "{\n \"invoiceCode\": \"a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] }, { "name": "Purchase invoice rendition", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/e-invoice/input/preview-base64", "host": [ "{{baseUrl}}" ], "path": [ "v1", "e-invoice", "input", "preview-base64" ] }, "description": "Download the PDF rendition of a purchase invoice as Base64.\n\nDocumentation: https://developers.tingee.vn/en/docs/hoa-don-dien-tu/hoa-don-dau-vao/preview-base64", "body": { "mode": "raw", "raw": "{\n \"invoiceCode\": \"a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [] } ] } ] }, { "name": "Other", "item": [ { "name": "Query e-wallet information (BaoKim)", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/direct-link/financial-utility/wallet-info?bankBin=BAOKIM&walletId=0987654321", "host": [ "{{baseUrl}}" ], "path": [ "v1", "direct-link", "financial-utility", "wallet-info" ], "query": [ { "key": "bankBin", "value": "BAOKIM" }, { "key": "walletId", "value": "0987654321" } ] }, "description": "Query the balance and details of a BaoKim e-wallet.\n\nDocumentation: https://developers.tingee.vn/en/docs/direct-link/wallet-info" }, "response": [] } ] } ] }