Transfer Antar Bank

BI Fast (Interbank Transfer)

Layanan BI Fast merupakan metode disbursement yang memungkinkan pemindahan dana antar bank secara real-time dengan efisien, cepat, dan aman.

Sebelum Integrasi

Pastikan Anda sudah menerima kredensial dari tim Espay.

Langkah Integrasi

Berikut ini merupakan langkah-langkah yang dapat Anda gunakan untuk integrasi dengan Disbursement – Transfer Interbank (BI Fast):

  1. Generate Access Token B2B

Sebelum melakukan permintaan, Anda harus mendapatkan Access Token B2B. Pelajari Access Token B2B

  1. Generate Signature Asymmetric

Setiap permintaan yang Anda kirim, akan divalidasi oleh Espay Disbursemet menggunakan parameter signature yang telah Anda buat. Pelajari pembuatan Signature Asymmetric.

  1. Validasi Nomor Rekening Tujuan

Sebelum transfer, cek rekening tujuan Anda untuk validasi nomor yang benar. Pelajari Inquiry Account External.

  1. Proses Transfer Dana
Tipe Value
Kode Layanan
18
Nama
API Trigger Interbank Transfer
HTTP Method
POST

Flow

Anda melakukan permintaan dengan mengirimkan parameter yang dibutuhkan, dan Espay Disbursement akan memberikan respons dalam bentuk JSON.

API URL

Environment URL
Sandbox
Port of HTTPS (443)
https://sandbox-api.espay.id/api/v1.0/transfer-interbank
Production
Port of HTTPS (443)
https://api.espay.id/api/v1.0/transfer-interbank
Nama Tipe Mandatory Keterangan
Content-Type
String
Y
Isi konten permintaan Anda.

Contoh:
application/json
X-TIMESTAMP
String (25)
Y
Tanggal dan waktu lokal customer saat ini.

Format:
yyyy-MM-ddThh:mi:ssTZD (ISO 8601)

Contoh:
2024-03-14T07:49:28+07:00
X-SIGNATURE
String (255)
Y
Kode yang digunakan untuk melakukan validasi transaksi. Pelajari Signature Asymmetric
X-EXTERNAL-ID
String (32)
Y
String Numerik. Kode referensi yang bersifat unik pada hari yang sama.
X-PARTNER-ID
String (50)
Y
Merchant code yang diberikan oleh tim Espay.
CHANNEL-ID
String (5)
Y
Kode channel.

Value:
ESPAY
Authorization
String
Y
Token akses dari B2B. Pelajari Access Token B2B

Format:
Bearer (access token).

Contoh:
Bearer ZDE1MTQxM2QwODE2Zj UyNjk3ZmY0NTA3ZDgwZ Tg2ZDcyNmQ4MTNlYw
Y: Yes, O: Optional, C: Conditional

Parameter Permintaan

Parameter Tipe Mandatory Keterangan
partnerReferenceNo
String (64)
Y
Kode referensi merchant yang unik.
amount
Array of Object
  value
String (16.2)
Y
Total transaksi.

Format:
Desimal .00 (ISO 4217)

Contoh:
150000.00
  currency
String (3)
Y
Kode mata uang transaksi.

Format:
  • Rupiah: IDR
beneficiaryAccountName
String (100)
Y
Nama rekening penerima.
beneficiaryAccountNo
String (16)
Y
Nomor rekening penerima.
beneficiaryAddress
String (100)
O
Alamat penerima.
beneficiaryBankCode
String (3)
Y
Kode bank penerima.
beneficiaryBankName
String (100)
Y
Nama bank penerima.
beneficiaryEmail
String (100)
O
Alamat email penerima.
customerReference
String (20)
O
ID unik customer.
currency
String (3)
Y
Kode mata uang transaksi.

Format:
  • Rupiah: IDR
sourceAccountNo
String (16)
Y
Nomor rekening sumber.
transactionDate
String (25)
Y
Tanggal dan waktu transaksi.

Format:
yyyy-MM- ddThh:mi:ssTZD (ISO 8601).

Contoh:
2022-08-21T14:56:11+07:00
feeType
String (25)
O
Tipe biaya transaksi.

Format:
  • Dibebankan kepada pengirim: OUR
  • Dibebankan kepada penerima: BEN
  • Pengirim akan dikenakan biaya Rp.1000, dan sisanya dibebankan ke penerima: SHA|1000
additionalInfo
Array of Object
  sourceAccountName
String (40)
C
Nama pemilik rekening sumber, mandatory untuk Bank Permata.
  remark
String (40)
C
Deskripsi transaksi, mandatory untuk Bank Permata dan Bank CIMB.
  sourceBankCode
String (3)
Y
Kode bank sumber. Lihat disni
  trxType
String (2)
C
Tipe transaksi, mandatory untuk bank CIMB.

Format:
  • GPN: 01
  • BI FAST: 02
  proxyValue
String (62)
C
Proxy value, mandatory untuk Bank CIMB.

Format:
  • Initials 62: 01
  • Email format: 02
  proxyType
String (2)
C
Proxy type, mandatory untuk Bank CIMB.

Format:
  • Account number: ""
  • Phone number: 01
  • Email: 02
  trxPurposeCode
String (8)
C
Kode tujuan transaksi, mandatory untuk Bank CIMB.

Format:
  • Investment: 01
  • Transfer og wealth: 02
  • Purchase: 03
  • Others: 99
  chargeBearerCode
String (4)
C
Kode mandatory untuk Bank Permata.

Fixed Value:
DEBT
  beneficiaryAccountType
String (4)
C
Tipe rekening penerima, mandatory untuk Bank Permata.

Format:
  • Current account: CACC
  • Savings Account: SVGS
  • Loan: LOAN
  • Credit Card: CCRD
  • E-Money: UESB
  • None of the above: OTHR
  purposeOfTransaction
String (2)
C
Kode tujuan transaksi, mandatory untuk Bank Permata.

Format:
  • Investment: 01
  • Transfer og wealth: 02
  • Purchase: 03
  • Others: 99
  beneficiaryCustomerType
String (2)
C
Kategori penerima, mandatory untuk Bank Permata.

Format:
  • Individual: 01
  • Corporate: 02
  • Government: 03
  • Remittance: 04
  • Others: 99
  memo
String (40)
C
Remark / deskripsi, mandatory untuk Bank Permata.

Format:
Tanpa special karakter seperti @, #, ! dsb.
  beneficiaryCustomerResidentStatus
String (2)
C
Status tempat tinggal penerima, mandatory untuk Bank Permata.

Format:
  • Resident: 1
  • Non-Resident: 2
  beneficiaryCustomerTownName
String (10)
C
Nama kota tempat tinggal penerima, mandatory untuk Bank Permata.

Format:
Jika tidak ada, isi dengan string kosong (“”).
  swiftCode
String (8)
Y
Kode identifikasi bank untuk transaksi internasional. Lihat disini
  transferType
String (1)
Y
Tipe transfer.

Format:
BI Fast: 5
Y: Yes, O: Optional, C: Conditional

Parameter Respons

Parameter Tipe Mandatory Keterangan
responseCode
String (7)
Y
Kode respon.

Format:
Kode HTTP + Kode Layanan + Kode Error. Lihat disini

Contoh:
200+18+00 = 2001800.
responseMessage
String (150)
Y
Deskripsi respon.
partnerReferenceNo
String (64)
Y
Kode referensi merchant yang unik.
referenceNo
String (64)
Y
Kode referensi dari bank.
beneficiaryAccountNo
String (16)
Y
Nomor rekening penerima.
beneficiaryBankCode
String (8)
O
Kode bank penerima.
sourceAccountNo
String (16)
Y
Nomor rekening sumber.
amount
Array of Object
  value
String (16.2)
O
Total transaksi.

Format:
Desimal .00 (ISO 4217)

Contoh:
150000.00
  currency
String (3)
O
Kode mata uang transaksi.

Format:
  • Rupiah: IDR
traceNo
String (16)
O
Nomor untuk melacak transaksi.
additionalInfo
Array of Object
Y: Yes, O: Optional, C: Conditional
  1. API Opsional

Espay Disbursement menyediakan API Opsional yang dapat Anda gunakan untuk mendukung kebutuhan disbursement lainnya.

Try It!

Anda bisa coba masukkan data sesuai dengan input yang telah disediakan. Setelah itu Anda submit dan lihat hasilnya!
























































Contoh Header

Content-Type:application/json
X-TIMESTAMP:2024-03-14T07:49:28+07:00
X-SIGNATURE:LbVH9JjY59G+ZgWXmvX/pUwCuswiBuw/w1I2Y+EOITaA/Tp2sYYYdcF1rKrbHI6Kz9sVZPlFOadbN/o7iPcRTJ0s71Kwi+/jWlM5qRw1IoZRnDkKYPRLehX2F7mlOLz5jOTWaDPeqI2rXOcF/yvASdWCwSY/gdutw4rDs9RYAv815j3pbOYNpYyvCHJgMjbJ2r2A191CWwnRzAFnOGJHJqgu1XebCdF44WhiQPDmf2IGonYzQZXS/Or1G8jRxC8PQ+L0/7TQOxI17evxAYZ4QYqUN4s17xALxX89aSgfA3yZYCqY5wq0/BJBXq4mxAUkR3QZ0dVoQMwse1WrFGPVhQ==
X-EXTERNAL-ID:a948d7db-1b8a-4f38-abc7-a9d68c245372
X-PARTNER-ID:SGWYESSISHOP
CHANNEL-ID:ESPAY
Authorization:Bearer 0BtYxiGK6LGLRlCM4fd5x7F6iiZRCRszYlbRXeVKirBJzPyXMobQ+y3G7NG7GNqdIQAXsyMF3dWusX9j/ifJWg==
































Contoh Permintaan

{
    "partnerReferenceNo": "523525234423423",
    "amount": {
        "value": "10000.00",
        "currency": "IDR"
    },
    "beneficiaryAccountName": "Yories Yolanda",
    "beneficiaryAccountNo": "888801901234567",
    "beneficiaryAddress": "Palembang",
    "beneficiaryBankCode": "002",
    "beneficiaryBankName": "Bank BRI",
    "beneficiaryEmail": "yories.yolanda@work.bri.co.id",
    "customerReference": "100520138",
    "currency": "IDR",
    "sourceAccountNo": "988901000187608",
    "transactionDate": "2024-03-14T07:49:28+07:00",
    "feeType": "BEN",
    "additionalInfo": {
        "sourceAccountName": "PT ABC",
        "remark": "Pencairan Dana",
        "sourceBankCode": "013",
        "chargeBearerCode": "DEBT",
        "beneficiaryAccountType": "SVGS",
        "purposeOfTransaction": "01",
        "beneficiaryCustomerType": "01",
        "memo": "Pemindahan Dana",
        "beneficiaryCustomerResidentStatus": "1",
        "beneficiaryCustomerTownName": "",
        "swiftCode": "BRINIDJA",
        "transferType": "5"
    }
}












































































































































Contoh Respons

{
    "responseCode": "2001800",
    "responseMessage": "Successful",
    "partnerReferenceNo": "2022091935776601369723117385",
    "referenceNo": "22091901021167",
    "beneficiaryAccountNo": "0611116411",
    "beneficiaryBankCode": "002",
    "sourceAccountNo": "0613008753",
    "amount": {
        "value": "892356.00",
        "currency": "IDR"

    },
    "traceNo": "1781927843",
    "additionalInfo": {}
}


Contoh Respons Negatif

{
    "responseCode": "4011801",
    "responseMessage": "Invalid Token (B2B)"
}


CURL

curl --location 'https://sandbox-api.espay.id/api/v1.0/transfer-interbank' \
--header 'Content-Type: application/json' \
--header 'X-TIMESTAMP: 2024-03-14T07:49:28+07:00' \
--header 'X-PARTNER-ID: SGWYESSISHOP' \
--header 'X-SIGNATURE: LbVH9JjY59G+ZgWXmvX/pUwCuswiBuw/w1I2Y+EOITaA/Tp2sYYYdcF1rKrbHI6Kz9sVZPlFOadbN/o7iPcRTJ0s71Kwi+/jWlM5qRw1IoZRnDkKYPRLehX2F7mlOLz5jOTWaDPeqI2rXOcF/yvASdWCwSY/gdutw4rDs9RYAv815j3pbOYNpYyvCHJgMjbJ2r2A191CWwnRzAFnOGJHJqgu1XebCdF44WhiQPDmf2IGonYzQZXS/Or1G8jRxC8PQ+L0/7TQOxI17evxAYZ4QYqUN4s17xALxX89aSgfA3yZYCqY5wq0/BJBXq4mxAUkR3QZ0dVoQMwse1WrFGPVhQ==' \
--header 'X-EXTERNAL-ID: a948d7db-1b8a-4f38-abc7-a9d68c245372' \
--header 'CHANNEL-ID: ESPAY' \
--header 'Authorization: Bearer 0BtYxiGK6LGLRlCM4fd5x7F6iiZRCRszYlbRXeVKirBJzPyXMobQ+y3G7NG7GNqdIQAXsyMF3dWusX9j/ifJWg==' \
--data '{
  {
    "partnerReferenceNo": "523525234423423",
    "amount": {
      "value": "10000.00",
      "currency": "IDR"
    },
    "beneficiaryAccountName": "Yories Yolanda",
    "beneficiaryAccountNo": "888801901234567",
    "beneficiaryAddress": "Palembang",
    "beneficiaryBankCode": "002",
    "beneficiaryBankName": "Bank BRI",
    "beneficiaryEmail": "yories.yolanda@work.bri.co.id",
    "customerReference": "100520138",
    "currency": "IDR",
    "sourceAccountNo": "988901000187608",
    "transactionDate": "2024-03-14T07:49:28+07:00",
    "feeType": "BEN",
    "additionalInfo": {
      "sourceAccountName": "PT ABC",
      "remark": "Pencairan Dana",
      "sourceBankCode": "013",
      "chargeBearerCode": "DEBT",
      "beneficiaryAccountType": "SVGS",
      "purposeOfTransaction": "01",
      "beneficiaryCustomerType": "01",
      "memo": "Pemindahan Dana",
      "beneficiaryCustomerResidentStatus": "1",
      "beneficiaryCustomerTownName": "",
      "swiftCode": "BRINIDJA",
      "transferType": "5"
    }
  }
}'
Scroll to Top