Internal Transfer

Intrabank Transfer

Transfer ke sesama bank (Intrabank Transfer) merupakan layanan disbursement yang digunakan untuk memindahkan dana tanpa melibatkan bank lain.

Langkah Integrasi

Berikut ini merupakan langkah-langkah yang dapat Anda gunakan untuk integrasi dengan Disbursement – Transfer Intrabank:

  1. Setup kredensial dan signature
  • Pastikan Anda sudah memiliki kredensial dari Espay seperti Merchant Name, Merchant Code, dll).
  • Lakukan generate signature menggunakan Asymmetric Signature untuk setiap permintaan yang dikirim ke Espay melalui Header. Pelajari Disbursement | Asymmetric Signature.
  1. Validasi Nomor Rekening Tujuan

Sebelum melakukan transfer, kirim permintaan Inquiry Account Internal untuk validasi nomor rekening tujuan. Pelajari Inquiry Account Internal.

  1. Membuat Transfer Confirmation

Transfer confirmation merupakan callback URL yang perlu Anda sediakan dan daftarkan untuk proses validasi. Pelajari lebih lanjut Transfer Confirmation.

  1. Proses Transfer Dana

Lakukan transfer dengan menggunakan Intrabank Transfer (API Trigger Intrabank Transfer).

Tipe Value
Kode Layanan
17
Nama
API Trigger Intrabank 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-intrabank
Production
Port of HTTPS (443)
https://api.espay.id/api/v1.0/transfer-intrabank
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 Disbursement | Asymmetric Signature.
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
C
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 (32)
Y
Kode referensi unik dari merchant.
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
beneficiaryAccountNo
String (16)
Y
Nomor rekening penerima.
beneficiaryEmail
String (64)
Y
Alamat email penerima.
currency
String (3)
Y
Kode mata uang transaksi.

Format:
  • Rupiah: IDR
customerReference
String (64)
Y
ID unik customer.
feeType
String (3)
Y
Tipe biaya transaksi.

Format:
  • Dibebankan kepada pengirim (default): OUR
  • Dibebankan kepada penerima: BEN
  • Pengirim akan dikenakan biaya Rp.1000, dan sisanya dibebankan ke penerima: SHA|1000
remark
String (64)
Y
Deskripsi.
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
additionalInfo
Array of Object
  economicActivity
String (255)
C
Aktivitas ekonomi. Lihat daftar aktivitas ekonomi di sini.
  transactionPurpose
String (2)
C
Tujuan transaksi. Lihat tujuan transaksi di sini.
  referenceNo
String (64)
C
Kode referensi dari bank. Wajib diisi jika sourceBankCode = 028.
  deviceId
String (32)
C
Kode unik perangkat yang dihasilkan secara acak. Wajib diisi jika sourceBankCode = 028.
  channel
String (32)
C
Media atau kanal tempat permintaan dikirimkan (contoh: mobilephone, web). Wajib diisi jika sourceBankCode = 028.
  sendEmailNotification 
Bloean
C
Wajib diisi jika sourceBankCode = 028. false.
  sourceBankCode
ContentString (3)
C
See the list of product codes here. Mandatory if sourceBankCode = 028.
Y: Yes, O: Optional, C: Conditional

Parameter Respons

Parameter Tipe Mandatory Keterangan
responseCode
String (7)
Y
Kode respon. Lihat kode respons di sini.

Format:
Kode HTTP + Kode Layanan + Kode Error

Contoh:
200+17+00 = 2001700.
responseMessage
String (150)
Y
Deskripsi respon.
beneficiaryAccountNo
String (16)
Y
Nomor rekening penerima.
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
referenceNo
String (64)
Y
Kode referensi dari bank jika sourceBankCode = 028.
additionalInfo
Array of Object
  economicActivity
String (255)
Y
Aktivitas ekonomi. Lihat daftar aktivitas ekonomi di sini.
  transactionPurpose
String (2)
Y
Tujuan transaksi. Lihat tujuan transaksi di sini.
partnerReferenceNo
String (32)
Y
Kode referensi unik dari merchant.
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
Y: Yes, O: Optional, C: Conditional
  1. Respons

Espay akan mengirimkan respons transfer berhasil atau tidak. Anda dapat melihat lebih detail pada halaman Disbursement | Kode Respons.

Layanan Tambahan Disbursement Lainnya
Espay Disbursement menyediakan API Opsional yang dapat Anda gunakan untuk mendukung kebutuhan disbursement lainnya.
Sample Headers

Content-Type:application/json
X-TIMESTAMP:2024-03-14T07:49:28+07:00
X-SIGNATURE:Ez4VM6yLWfgSLPZifeXDxjc8ko6IK1qa9V0nvohRGAL5dgfCXgpjMShRB+r4wthYwsb2BUSOh//gW0a2qqnVwUbg31MdUytp9FnZq6O7Kp6jGHSConvkaxMSp764iFCbpcjciaGwekXFmIdfnRB3Tn988Yz89Vb6qhxRZ30aLha+2JoRbY7ajy1Ml/upOvmmhhuwCdXgzjcsNVpSUO2RPag9Zasx+gmUc7vX4kWcpkd5gjNpp1d9h/arKaO+0xWYELWbbVyDUkwVdydhsH5YDMd5vt1TS/49lNSH/eMN1QevI7ayV3cxv8YP3i7QwBncXOV24OXNpxvegxabn/5CCA==
X-EXTERNAL-ID:a948d7db-1b8a-4f38-abc7-a9d68c245372
X-PARTNER-ID:SGWYESSISHOP
CHANNEL-ID:ESPAY
Authorization:Bearer zSOwxBf/NXOesRn9cPj1X+jCZp1OZ15tpdPlGoLtrfv7h+RF2H9uCZVNO5qOQS4cNCgtQGyHyYjj13UoPWo5hg==


































Sample Request

{
    "partnerReferenceNo": "2020102900000020220902",
    "amount": {		
        "value": "892356.00",
        "currency": "IDR"
    },
    "beneficiaryAccountNo": "888801000157508",
    "beneficiaryEmail": "[email protected]",
    "currency": "IDR",
    "customerReference": "10052019",
    "feeType": "BEN",
    "remark": "remark test",
    "sourceAccountNo": "0613339253",
    "transactionDate": "2024-03-14T10:30:24+07:00",
    "additionalInfo": {
        "economicActivity": "Biaya Hidup Pihak Asing",
        "transactionPurpose": "01",
        "referenceNo": "BVFAST473297424328",
        "deviceId": "12345679237",
        "channel": "mobilephone",
        "sendEmailNotification":false,
        "sourceBankCode":"028"
    }
}





























































Sample Positive Response

{
    "responseCode": "2001700",
    "responseMessage": "Successful",
    "beneficiaryAccountNo": "888801000157508",
    "amount": {
        "value": "892356.00",
        "currency": "IDR"
    },
    "referenceNo": "22091901021167",
    "additionalInfo": {
        "economicActivity": "Biaya Hidup Pihak Asing",
        "transactionPurpose": "01"
    },
    "partnerReferenceNo": "2020102900000020220902",
    "sourceAccountNo": "0613339253",
    "transactionDate": "2024-03-14T10:30:24+07:00"
}


Sample Negative Response

{
    "responseCode": "4011701",
    "responseMessage": "Unauthorized. IP Address rejected / unregistered"
}


HTTP

POST /api/v1.0/transfer-intrabank HTTP/1.1
Host: sandbox-api.espay.id
Content-Type: application/json
X-TIMESTAMP: 2024-03-14T07:49:28+07:00
X-SIGNATURE: Ez4VM6yLWfgSLPZifeXDxjc8ko6IK1qa9V0nvohRGAL5dgfCXgpjMShRB+r4wthYwsb2BUSOh//gW0a2qqnVwUbg31MdUytp9FnZq6O7Kp6jGHSConvkaxMSp764iFCbpcjciaGwekXFmIdfnRB3Tn988Yz89Vb6qhxRZ30aLha+2JoRbY7ajy1Ml/upOvmmhhuwCdXgzjcsNVpSUO2RPag9Zasx+gmUc7vX4kWcpkd5gjNpp1d9h/arKaO+0xWYELWbbVyDUkwVdydhsH5YDMd5vt1TS/49lNSH/eMN1QevI7ayV3cxv8YP3i7QwBncXOV24OXNpxvegxabn/5CCA==
X-EXTERNAL-ID: a948d7db-1b8a-4f38-abc7-a9d68c245372
X-PARTNER-ID: SGWYESSISHOP
CHANNEL-ID: ESPAY
Authorization: Bearer zSOwxBf/NXOesRn9cPj1X+jCZp1OZ15tpdPlGoLtrfv7h+RF2H9uCZVNO5qOQS4cNCgtQGyHyYjj13UoPWo5hg==
Content-Length: 556

{
    "partnerReferenceNo": "2020102900000020220902",
    "amount": {		
        "value": "892356.00",
        "currency": "IDR"
    },
    "beneficiaryAccountNo": "888801000157508",
    "beneficiaryEmail": "[email protected]",
    "currency": "IDR",
    "customerReference": "10052019",
    "feeType": "BEN",
    "remark": "remark test",
    "sourceAccountNo": "0613339253",
    "transactionDate": "2024-03-14T10:30:24+07:00",
    "additionalInfo": {
        "economicActivity": "Biaya Hidup Pihak Asing",
        "transactionPurpose": "01",
        "referenceNo": "BVFAST473297424328",
        "deviceId": "12345679237",
        "channel": "mobilephone",
        "sendEmailNotification":false,
        "sourceBankCode":"028"
    }
}


CURL

curl --location 'https://sandbox-api.espay.id/api/v1.0/transfer-intrabank' \
--header 'Content-Type: application/json' \
--header 'X-TIMESTAMP: 2024-03-14T07:49:28+07:00' \
--header 'X-SIGNATURE: Ez4VM6yLWfgSLPZifeXDxjc8ko6IK1qa9V0nvohRGAL5dgfCXgpjMShRB+r4wthYwsb2BUSOh//gW0a2qqnVwUbg31MdUytp9FnZq6O7Kp6jGHSConvkaxMSp764iFCbpcjciaGwekXFmIdfnRB3Tn988Yz89Vb6qhxRZ30aLha+2JoRbY7ajy1Ml/upOvmmhhuwCdXgzjcsNVpSUO2RPag9Zasx+gmUc7vX4kWcpkd5gjNpp1d9h/arKaO+0xWYELWbbVyDUkwVdydhsH5YDMd5vt1TS/49lNSH/eMN1QevI7ayV3cxv8YP3i7QwBncXOV24OXNpxvegxabn/5CCA==' \
--header 'X-EXTERNAL-ID: a948d7db-1b8a-4f38-abc7-a9d68c245372' \
--header 'X-PARTNER-ID: SGWYESSISHOP' \
--header 'CHANNEL-ID: ESPAY' \
--header 'Authorization: Bearer zSOwxBf/NXOesRn9cPj1X+jCZp1OZ15tpdPlGoLtrfv7h+RF2H9uCZVNO5qOQS4cNCgtQGyHyYjj13UoPWo5hg==' \
--data-raw '{
    "partnerReferenceNo": "2020102900000020220902",
    "amount": {		
        "value": "892356.00",
        "currency": "IDR"
    },
    "beneficiaryAccountNo": "888801000157508",
    "beneficiaryEmail": "[email protected]",
    "currency": "IDR",
    "customerReference": "10052019",
    "feeType": "BEN",
    "remark": "remark test",
    "sourceAccountNo": "0613339253",
    "transactionDate": "2024-03-14T10:30:24+07:00",
    "additionalInfo": {
        "economicActivity": "Biaya Hidup Pihak Asing",
        "transactionPurpose": "01",
        "referenceNo": "BVFAST473297424328",
        "deviceId": "12345679237",
        "channel": "mobilephone",
        "sendEmailNotification":false,
        "sourceBankCode":"028"
    }
}'
Scroll to Top