Transfer Antar Bank

RTGS (Real Time Gross Settlement)

Layanan Transfer RTGS (Real Time Gross Settlement) adalah metode disbursement yang digunakan untuk memindahkan dana antar bank dalam jumlah besar secara 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 RTGS:

  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
22
Nama
API Transfer RTGS
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-rtgs
Production
Port of HTTPS (443)
https://api.espay.id/api/v1.0/transfer-rtgs
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 (255)
O
Alamat penerima.
beneficiaryBankCode
String (10)
Y
Kode bank / kode swift penerima. Lihat disini
beneficiaryBankName
String (100)
Y
Nama bank penerima.
beneficiaryEmail
String (100)
Y
Alamat email penerima.
beneficiaryCustomerResidence
String (1)
Y
Domisili penerima.

Format:
  • Indonesia: 1
  • Non Indonesia: 2
beneficiaryCustomerType
String (1)
Y
Kategori penerima.

Format:
  • Individual: 1
  • Corporation: 2
  • Government: 3
feeType
String (25)
O
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
receiverPhone
String (20)
O
Nomor handphone penerima.

Format:
Inisial 62

Contoh:
6297322173827
remark
String (40)
Y
Deskripsi.
senderCustomerResidence
String (1)
O
Domisili pengirim.

Format:
  • Indonesia: 1
  • Non Indonesia: 2
senderCustomerType
String (1)
O
Kategori pengirim.

Format:
  • Individual: 1
  • Corporation: 2
  • Government: 3
senderPhone
String (20)
O
Nomor handphone pengirim.

Format:
Inisial 62

Contoh:
6297322173827
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
customerReference
String (20)
Y
ID unik customer.
additionalInfo
Array of Object
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+22+00 = 2002200.
responseMessage
String (150)
Y
Deskripsi respon.
referenceNo
String (64)
Y
ID transaksi dari bank.
partnerReferenceNo
String (64)
Y
Kode referensi merchant.
beneficiaryAccountName
String (100)
O
Nama rekening penerima.
beneficiaryAccountNo
String (16)
Y
Nomor rekening penerima.
beneficiaryBankCode
String (8)
O
Kode bank penerima. Lihat disini
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
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
transactionStatus
String (2)
Y
Status transaksi.

Format:
  • Success: 00
  • Initiated: 01
  • Paying: 02
  • Pending: 03
  • Refunded: 04
  • Canceled: 05
  • Failed: 06
  • Not found: 07
transactionStatusDesc
String (50)
O
Deskripsi status transaksi.
traceNo
String (16)
O
Nomor untuk melacak transaksi.
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:2022-07-01T14:56:11+07:00
X-SIGNATURE:UBlrzLTRxydxkOlbi/DDxP+WrBbh4vlXMQlEwGqEeevawdZSnnvRHcnFi+jSbXpsmoi8haZhFlfj3VHC41e67WZp7grFunReVvKFRE0rU7IzAYq6KsEO8Nu/u/XmRhN33SiDuHWnprtadTEiewVlqMeNjjlvFTf9MUVH2PEwG05kv+kmhgnq8ZxW06rRIuG6ot3BFrWiu1Bk6QD5dYRnryqC3J5YOC/dnC0mFg98EO06KEKrmOOjMplqruzOfZyVCw3kiE3iB0Okovb6croBzxkKBSzehWiejLsEJFZbEIJul7aboGT0ssW8MmAc5XAFXQN0SkYyOWMBlAzMWgy1pg==
X-EXTERNAL-ID: 4feb84d9-4cd2-497d-a455-b2c01dd41361
X-PARTNER-ID:SGWYESSISHOP
CHANNEL-ID:ESPAY
Authorization:Bearer oDNkj+fycJ0rbsqa17PIiYWm8Y1c/5jg4CSCnOjCS4xxHrVo42WpH+28jkoN5E6EWx5k2LXyDHnQWDYPvpEyQw==
































Contoh Permintaan

{
    "partnerReferenceNo": "432531252342",
    "amount": {
        "value": "101000000.00",
        "currency": "IDR"
    },
    "beneficiaryAccountName": "Yories Yolanda",
    "beneficiaryAccountNo": "888801000157508",
    "beneficiaryAddress": "Palembang",
    "beneficiaryBankCode": "002",
    "beneficiaryBankName": "BRI",
    "beneficiaryCustomerResidence": "1",
    "beneficiaryCustomerType": "1",
    "feeType": "BEN",
    "receiverPhone": "6281234567890",
    "remark": "remark test",
    "senderCustomerResidence": "1",
    "senderCustomerType": "1",
    "senderPhone": "6281234567890",
    "sourceAccountNo": "001901000613303",
    "transactionDate": "2021-03-29T12:08:56+07:00",
    "customerReference": "10052111",
    "additionalInfo": {}
}
















































































Contoh Respons Positif

{
    "responseCode": "2002200",
    "responseMessage": "Successful",
    "referenceNo": "432531252342",
    "partnerReferenceNo": "2022093001044639936023037186",
    "beneficiaryAccountName": "Yories Yolanda",
    "beneficiaryAccountNo": "888801000157508",
    "beneficiaryBankCode": "002",
    "currency":"IDR",
    "sourceAccountNo": "001901000613303",
    "transactionDate": "2022-09-30T09:37:52+07:00",
    "amount": {
        "value": "10000.00",
        "currency": "IDR"
    },
    "transactionStatus": "00",
    "transactionStatusDesc": "success",
    "traceNo": "CRTGS775228888394"
}

Contoh Respons Negatif

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





CURL

curl --location 'https: //sandbox-api.espay.id/api/v1.0/transfer-rtgs' \
--header 'Content-Type: application/json' \
--header 'X-TIMESTAMP: 2022-07-01T14:56:11+07:00' \
--header 'X-SIGNATURE: UBlrzLTRxydxkOlbi/DDxP+WrBbh4vlXMQlEwGqEeevawdZSnnvRHcnFi+jSbXpsmoi8haZhFlfj3VHC41e67WZp7grFunReVvKFRE0rU7IzAYq6KsEO8Nu/u/XmRhN33SiDuHWnprtadTEiewVlqMeNjjlvFTf9MUVH2PEwG05kv+kmhgnq8ZxW06rRIuG6ot3BFrWiu1Bk6QD5dYRnryqC3J5YOC/dnC0mFg98EO06KEKrmOOjMplqruzOfZyVCw3kiE3iB0Okovb6croBzxkKBSzehWiejLsEJFZbEIJul7aboGT0ssW8MmAc5XAFXQN0SkYyOWMBlAzMWgy1pg==' \
--header 'X-EXTERNAL-ID: 4feb84d9-4cd2-497d-a455-b2c01dd41361' \
--header 'X-PARTNER-ID: SGWYESSISHOP' \
--header 'CHANNEL-ID: ESPAY' \
--header 'Authorization: Bearer oDNkj+fycJ0rbsqa17PIiYWm8Y1c/5jg4CSCnOjCS4xxHrVo42WpH+28jkoN5E6EWx5k2LXyDHnQWDYPvpEyQw==' \
--data '{
    "partnerReferenceNo": "432531252342",
    "amount": {
        "value": "101000000.00",
        "currency": "IDR"
    },
    "beneficiaryAccountName": "Yories Yolanda",
    "beneficiaryAccountNo": "888801000157508",
    "beneficiaryAddress": "Palembang",
    "beneficiaryBankCode": "002",
    "beneficiaryBankName": "BRI",
    "beneficiaryEmail": "yories.yolanda@work.co.id",
    "beneficiaryCustomerResidence": "1",
    "beneficiaryCustomerType": "1",
    "feeType": "BEN",
    "receiverPhone": "6281234567890",
    "remark": "remark test",
    "senderCustomerResidence": "1",
    "senderCustomerType": "1",
    "senderPhone": "6281234567890",
    "sourceAccountNo": "001901000613303",
    "transactionDate": "2021-03-29T12:08:56+07:00",
    "customerReference": "10052111",
    "additionalInfo": {}
}'
Scroll to Top