Documentation — transferuang API

endpoint

POST api.transferuang.com/send-to

Transfer dana ke satu atau banyak rekening bank / e-wallet dalam satu request.
Setiap penerima diproses secara paralel; status tiap transfer dikirim via notification_url.

⚡ Header wajib: Authorization: Bearer YOUR_API_KEY && Content-Type: application/json

fieldtypeketerangan

notification_urloptional

string

URL webhook yang menerima callback async per transfer selesai.

ex: "https://yourdomain.com/callback"

send_torequired

array

Array penerima transfer. Minimal 1, maksimal 1.000 objek.

unique_transaction_idrequired

string

ID unik per penerima — digunakan untuk idempotency dan tracking.

ex: "TXN-20250426-001"

bank_coderequired

string

Kode bank / e-wallet tujuan (lihat referensi di halaman utama).

ex: "BCA", "GOPAY", "OVO"

amountrequired

integer

Nominal transfer dalam Rupiah (IDR). Minimum Rp 10.000.

ex: 150000

namerequired

string

Nama penerima sesuai nama rekening / akun terdaftar.

ex: "Budi Santoso"

curl -X POST https://api.transferuang.com/send-to \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "notification_url": "https://yourdomain.com/callback",
    "send_to": [
      {
        "unique_transaction_id": "TXN-20250426-001",
        "bank_code": "BCA",
        "amount": 150000,
        "name": "Budi Santoso"
      },
      {
        "unique_transaction_id": "TXN-20250426-002",
        "bank_code": "GOPAY",
        "amount": 75000,
        "name": "Siti Rahayu"
      }
    ]
  }'

const response = await fetch('https://api.transferuang.com/send-to', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    notification_url: 'https://yourdomain.com/callback',
    send_to: [
      {
        unique_transaction_id: 'TXN-20250426-001',
        bank_code: 'BCA',
        amount: 150000,
        name: 'Budi Santoso',
      },
      {
        unique_transaction_id: 'TXN-20250426-002',
        bank_code: 'GOPAY',
        amount: 75000,
        name: 'Siti Rahayu',
      },
    ],
  }),
});

const data = await response.json();
console.log(data);

import requests

response = requests.post(
    'https://api.transferuang.com/send-to',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json',
    },
    json={
        'notification_url': 'https://yourdomain.com/callback',
        'send_to': [
            {
                'unique_transaction_id': 'TXN-20250426-001',
                'bank_code': 'BCA',
                'amount': 150000,
                'name': 'Budi Santoso',
            },
            {
                'unique_transaction_id': 'TXN-20250426-002',
                'bank_code': 'GOPAY',
                'amount': 75000,
                'name': 'Siti Rahayu',
            },
        ],
    }
)

data = response.json()
print(data)

const https = require('https');

const body = JSON.stringify({
  notification_url: 'https://yourdomain.com/callback',
  send_to: [
    {
      unique_transaction_id: 'TXN-20250426-001',
      bank_code: 'BCA',
      amount: 150000,
      name: 'Budi Santoso',
    },
  ],
});

const options = {
  hostname: 'api.transferuang.com',
  path: '/send-to',
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
    'Content-Length': Buffer.byteLength(body),
  },
};

const req = https.request(options, res => {
  let data = '';
  res.on('data', chunk => { data += chunk; });
  res.on('end',  ()    => { console.log(JSON.parse(data)); });
});
req.write(body);
req.end();

{
  "name": "transferuang · send-to",
  "nodes": [
    {
      "parameters": {
        "method": "POST",
        "url": "https://api.transferuang.com/send-to",
        "sendHeaders": true,
        "headerParameters": {
          "parameters": [
            {
              "name": "Authorization",
              "value": "Bearer YOUR_API_KEY"
            },
            {
              "name": "Content-Type",
              "value": "application/json"
            }
          ]
        },
        "sendBody": true,
        "specifyBody": "json",
        "jsonBody": "{\n  \"notification_url\": \"https://yourdomain.com/callback\",\n  \"send_to\": [\n    {\n      \"unique_transaction_id\": \"TXN-20250426-001\",\n      \"bank_code\": \"BCA\",\n      \"amount\": 150000,\n      \"name\": \"Budi Santoso\"\n    }\n  ]\n}",
        "options": {}
      },
      "id": "a1b2c3d4-0001-4000-8000-transferuang1",
      "name": "HTTP Request",
      "type": "n8n-nodes-base.httpRequest",
      "typeVersion": 4.2,
      "position": [500, 300]
    }
  ],
  "connections": {},
  "active": false,
  "settings": {
    "executionOrder": "v1"
  },
  "versionId": "tu-send-to-v1",
  "meta": {
    "templateCredsSetupCompleted": true
  },
  "id": "tu-send-to"
}

response · 200 OK

{
  "status": "accepted",
  "batch_id": "BATCH-20250426-XYZ789",
  "total": 2,
  "results": [
    {
      "unique_transaction_id": "TXN-20250426-001",
      "status": "processing",
      "fee": 2500
    },
    {
      "unique_transaction_id": "TXN-20250426-002",
      "status": "processing",
      "fee": 2500
    }
  ]
}

endpoint

POST api.transferuang.com/saldo

Cek saldo akun yang tersedia untuk transfer. Tidak memerlukan request body.

⚡ Header wajib: Authorization: Bearer YOUR_API_KEY

curl -X POST https://api.transferuang.com/saldo \
  -H "Authorization: Bearer YOUR_API_KEY"

const response = await fetch('https://api.transferuang.com/saldo', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
  },
});

const data = await response.json();
console.log(data);

import requests

response = requests.post(
    'https://api.transferuang.com/saldo',
    headers={'Authorization': 'Bearer YOUR_API_KEY'}
)

data = response.json()
print(data)

{
  "name": "transferuang · saldo",
  "nodes": [
    {
      "parameters": {
        "method": "POST",
        "url": "https://api.transferuang.com/saldo",
        "sendHeaders": true,
        "headerParameters": {
          "parameters": [
            {
              "name": "Authorization",
              "value": "Bearer YOUR_API_KEY"
            }
          ]
        },
        "options": {}
      },
      "id": "b2c3d4e5-0002-4000-8000-transferuang2",
      "name": "HTTP Request",
      "type": "n8n-nodes-base.httpRequest",
      "typeVersion": 4.2,
      "position": [500, 300]
    }
  ],
  "connections": {},
  "active": false,
  "settings": {
    "executionOrder": "v1"
  },
  "versionId": "tu-saldo-v1",
  "meta": {
    "templateCredsSetupCompleted": true
  },
  "id": "tu-saldo"
}

response · 200 OK

{
  "saldo": 12500000,
  "currency": "IDR",
  "account_id": "ACC-00123"
}

endpoint

POST api.transferuang.com/history

Ambil riwayat transaksi dalam rentang tanggal tertentu.

⚡ Header wajib: Authorization: Bearer YOUR_API_KEY && Content-Type: application/json

fieldtypeketerangan

date_rangerequired

object

Rentang tanggal untuk filter riwayat transaksi.

fromrequired

string

Tanggal mulai format ISO 8601 (YYYY-MM-DD).

ex: "2025-01-01"

torequired

string

Tanggal akhir format ISO 8601 (YYYY-MM-DD).

ex: "2025-01-31"

curl -X POST https://api.transferuang.com/history \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "date_range": {
      "from": "2025-01-01",
      "to": "2025-01-31"
    }
  }'

const response = await fetch('https://api.transferuang.com/history', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    date_range: {
      from: '2025-01-01',
      to: '2025-01-31',
    },
  }),
});

const data = await response.json();
console.log(data);

import requests

response = requests.post(
    'https://api.transferuang.com/history',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json',
    },
    json={
        'date_range': {
            'from': '2025-01-01',
            'to': '2025-01-31',
        }
    }
)

data = response.json()
print(data)

{
  "name": "transferuang · history",
  "nodes": [
    {
      "parameters": {
        "method": "POST",
        "url": "https://api.transferuang.com/history",
        "sendHeaders": true,
        "headerParameters": {
          "parameters": [
            {
              "name": "Authorization",
              "value": "Bearer YOUR_API_KEY"
            },
            {
              "name": "Content-Type",
              "value": "application/json"
            }
          ]
        },
        "sendBody": true,
        "specifyBody": "json",
        "jsonBody": "{\n  \"date_range\": {\n    \"from\": \"2025-01-01\",\n    \"to\": \"2025-01-31\"\n  }\n}",
        "options": {}
      },
      "id": "c3d4e5f6-0003-4000-8000-transferuang3",
      "name": "HTTP Request",
      "type": "n8n-nodes-base.httpRequest",
      "typeVersion": 4.2,
      "position": [500, 300]
    }
  ],
  "connections": {},
  "active": false,
  "settings": {
    "executionOrder": "v1"
  },
  "versionId": "tu-history-v1",
  "meta": {
    "templateCredsSetupCompleted": true
  },
  "id": "tu-history"
}

response · 200 OK

{
  "total": 2,
  "date_range": {
    "from": "2025-01-01",
    "to": "2025-01-31"
  },
  "transactions": [
    {
      "unique_transaction_id": "TXN-20250115-001",
      "bank_code": "BCA",
      "amount": 150000,
      "name": "Budi Santoso",
      "status": "success",
      "fee": 2500,
      "created_at": "2025-01-15T10:32:00Z"
    },
    {
      "unique_transaction_id": "TXN-20250122-005",
      "bank_code": "GOPAY",
      "amount": 75000,
      "name": "Siti Rahayu",
      "status": "success",
      "fee": 2500,
      "created_at": "2025-01-22T14:08:00Z"
    }
  ]
}

API documentation