NAV Navbar
Logo

Faspay Business

Image of debit


Faspay Business memungkinkan e-commerce Anda untuk menerima pembayaran secara online, Anda dapat memilih antara Kredit atau Saluran Debit, mulai dari internet banking, akun virtual, hingga e-wallet. Bermitra dengan Bank dan Telco terbaik di Indonesia akan menguntungkan Anda untuk menerima pembayaran dari lebih dari 120 Bank secara nasional dimana sistem pembayaran faspay akan diembed ke situs web Anda sehingga customer dapat melakukan pembayaran.

Faspay Billing

Image of debit


Faspay Billing memungkinkan Anda membuat faktur email yang memungkinkan Anda menerima pembayaran secara online fitur pembayaran yang sama seperti Faspay Business tetapi melayani pengguna yang berbeda. Gunakan fitur ini untuk mengambil pesanan offline Anda, Lacak faktur Anda dengan dasbor kami. Yang terbaik adalah Anda tidak memerlukan integrasi apa pun. Kami memahami bahwa terkadang bisnis Anda juga memesan secara offline. Produk ini cocok untuk bisnis yang masih menerima pesanan secara offline (melalui telepon, email, atau di situs pesanan), Anda kemudian akan dapat membuat faktur digital untuk dikirim melalui email, sedangkan pembeli akan dapat melakukan pembayaran langsung pada email . Sangat sederhana dan nyaman.

Faspay Xpress

Image of debit


Faspay Xpress. Kami memahami bahwa waktu dan sumber daya adalah aset berharga bagi bisnis Anda. Mengembangkan fitur pembayaran terkadang bisa menjadi tantangan bagi Anda karena akan memakan waktu dan sumber daya Anda, itu berarti lebih banyak biaya. Pikirkan berapa fitur pembayaran bank yang tersedia.

Bagaimana kalau menggunakan Faspay Xpress? Faspay Xpress dirancang untuk memenuhi kebutuhan pedagang kami dari satu halaman pembayaran tetapi kekurangan sumber daya untuk membuatnya. Yang perlu Anda lakukan adalah menghubungkan API Anda ke kami untuk memanggil halaman pembayaran ini. Dengan fitur ini, setiap kali Anda memutuskan untuk mengaktifkan atau mematikan saluran, beri tahu kami dan kami akan menyelesaikannya untuk Anda.

Faspay SendMe

Introduction

Faspay Send Me (Disbursement) adalah salah satu produk Faspay yang dapat membantu user untuk mempermudah proses transfer dana / uang ke semua bank di Indonesia dengan cepat menggunakan layanan API otomatis kami dengan dukungan 24/7 jam. Faspay Disbursement juga membantu Anda untuk menghindari kesalahan manusia yang disebabkan oleh proses manual atau kesulitan dalam menggunakan akun dari banyak bank.

Credential

Jika ingin menggunakan layanan ini, Merchant harus menggunakan 4 ID / kode unik bersifat rahasia dari Faspay:

Gambaran API Faspay :

Metode Endpoint URL Service Name
GET /account/api/tokens Mendapatkan akses tokern
POST /account/api/register Akun Registrasi
POST /account/api/register/confirm Konfirmasi akun registrasi
POST /account/api/transfer Transfer akun ke akun lain
GET /account/api/inquiry_name/< va_merchant >/< va_number > Nama Inquiry
GET /account/api/balance_inquiry/< va_merchant > Jumlah saldo inquiry
GET /account/api/account_mutasi/< va_merchant >/< start_date >/< end_date > Akun mutasi
GET /account/api/inquiry_status/< virtual_account >/< trx_no >/< trx_id > Status transaksi inquiry
*trx id optional, jika inquiry tanpa trx_id :
GET /account/api/inquiry_status/< virtual_account >/< trx_no > Status transaksi inquiry

Authentication

Faspay account APIs atau SendMe menggunakan OAuth 2.0 sebagai otorisasi. Pertama, anda harus generated token akses, gunakan 6 ID rahasia dari Faspay App Key, App Secret, Client Key, Client Secret, Faspay Key dan Faspay Secret. dan token akses digunakan untuk faspay account API service.

Request :

Setting Value
Path/Relative URL gunakan URL atau alamat akses sesuai dengan layanan yang digunakan (merujuk pada Faspay API) and untuk menghasilkan sebuah signature untuk mengakses layanan tersebut.
Host Development https://dev2.faspay.co.id
Host Production https://sendme.faspay.co.id

Untuk mengakses semua layanan, Anda akan memerlukan token akses, untuk mendapatkan token akses, Anda harus diotorisasi header oleh faspay_secret, app_key, app_secret dengan aturan metode enkripsi: AES 256 dan untuk keamanan Header anda bisa generate dengan beberapa parameter sesuai dibawah ini :

Key Value
Faspay-Key Provide by faspay
Faspay-Timestamp Waktu (Y-m-d H:i:s)
Faspay-Signature Signature merujuk ke signature section
Faspay-Authorization Metode enkripsi : AES 256 (FASPAY_SECRET:APP_KEY:APP_SECRET)
Content-Type application/json

Authorization

Bagian ini akan menjelaskan bagaimana Faspay account menggunakan metode enkripsi AES 256 untuk otorisasi.

Contoh :

Signature

Signature digunakan oleh Faspay untuk memverifikasi bahwa permintaan Anda tidak diubah. Proses signature menggunakan format sebagai berikut:

Generate signature token

Untuk Menghasilkan token signature,anda bisa menggunakan formula dibawah ini :

Parameter Value
method GET
path definisikan service URL yang akan digunakan (daftar dari servis)
timestamp datetime (Y-m-d H:i:s). Sample : 2018-10-09 14:24:00
token base64_encode (CLIENT_KEY:CLIENT_SECRET)
request_body untuk servis ini, set request body ke string kosong
StringToSign " [method]:[path]:[timestamp]:[access_token]:[request_body]:[request_body] ”
*) tanpa [] dan ""
faspay_secret akan diberikan oleh faspay

Generate signature untuk service lainnya

Untuk generate signature layanan lainnya di faspay disbursement ini, anda dapat menggunakan format dibawah ini :

Parameter Value
method POST / GET(based on service API)
path definisikan service URL yang akan digunakan (daftar dari servis)
timestamp datetime (Y-m-d H:i:s). Sample : 2018-10-09 14:24:00
token base64_encode (CLIENT_KEY:CLIENT_SECRET:ACCESS_TOKEN)
AccessToken sebuah token yang telah dimiliki oleh merchant sesuai dengan service token yang akan digunakan
request_body untuk servis ini, set request body ke string kosong
StringToSign "[method]:[path]:[timestamp]:[access_token]:[request_body]"
*) tanpa [] dan ""
faspay_secret akan diberikan oleh faspay

HTTP Method

Relative URL

Full URL Relative URL
https://example.com/account/api/tokens /account/api/tokens
https://example.com or https://example.com/ /

URL relatif harus dienkode URI sesuai dengan aturan berikut:

Parameter string kueri harus diurutkan ulang sesuai dengan aturan berikut:

Request Body

Access Token

Sample response

{
    "access_token": "rlUdeRhExemf/Fj1srv3GIBhN76boY7+fRWIpdkVDsf9/Xv0f5j8f8VnX1HB98gZcIPtkxSggceveNaM/q41QsEepCo459/VwfKaQlbZZvIBPY4z8d9yMyJKVRvSTUz30oiFhDOaAOMChhqWCIWWoSC9twG+WB5LozrazkkWUkqJcvE0uKedBXHHrPZASi1zj/pHDfaAmLLOyuqaHGuE64DnMA86CznFqy/wVEuJWG1u5BcJQhLmzi1fYtQgwLQhqCoU8dNvD2Ydir7Wg1dh6u04MS6XwiN41N+NRbq0+8YcfrH4p5QdjZgCRM5kjWb28oj7e5ehubHwd03zlyb7QkEBFyOW1rfJhwvlfsp83Po4E9+mRVyxP57NmtumMaH+9JtVzluJGtbYu6cXTDmeGjOBI2+IyjA8Wf4c+XVQJY7r1NRX7E1wjJHh6t0OI41pvcNCrMkunDX3bN3SNPC3eHF7SuK6A6uUlcy83npOKYYcWKQpa8DgySXT5TBNyx3PjcPwutilU4+qyhsBjdZP+dE4vcgoPvRK5eAcraU7+YrfD2GdvtobGiGgs2NcmoINV+6dI+x4iBHqbnQhD721C9x1RxijmghAv6Jvxhz1MqC7Tw5hqB9vpaMhK1Nx2qHmEzrZOf2EsfrRkvDLznRxkWQ1B+8n5XbocifLeyxk2Gc=",
    "expired_in": "36000",
    "status": "2",
    "message": "Success",
    "response_code": "00",
    "response_desc": "success"
}

Access_token adalah sebuah string token yang digunakan untuk identifikasi user dari API. Token ini dibutuhkan setiap kali aplikasi memanggil API. permintaan Access_token harus dibuat sesuai kriteria dibawah ini :

dan juga harus membuat signature dan request header.

*)Response :

No Parameter Type length Mandatory/Optional Description
1 Access_token AN M Respon akses token dari faspay
2 Expired_in N M Waktu expire (dalam detik)
3 Status N 1 M Status = 2
4 Message AN M Deskripsi status
5 Response_code N 2 M Respon = 00
6 Response_desc AN 32 M Respon deskripsi dari bank

API Services

Register Account

Sample Request

{  
  "virtual_account" : "9920000082",
  "beneficiary_account" : "1020006137993",
  "beneficiary_account_name" : "Faspay Collection 1",
  "beneficiary_va_name" : "Faspay Collection 1",
  "beneficiary_bank_code" : "008",
  "beneficiary_bank_branch" : "Mandiri KCP",
  "beneficiary_region_code" : "0102",
  "beneficiary_country_code" : "ID",
  "beneficiary_purpose_code" : "1"

}

Layanan ini dapat digunakan oleh user / merchant untuk mendaftarkan akun tujuan transfer dananya (pendaftaran rekening tujuan). Gunakan Relative URL ini untuk generate signature :

dan juga harus membuat signature dan menggunakan request header + request body.

*)Request body:

No Parameter Type Length Mandatory/Optional Description
1 virtual_account N 20 M VA Merchant
2 beneficiary_account N 128 M Nomor Rekening Tujuan
3 beneficiary_account_name AN 255 M Nama Rekening Tujuan
4 beneficiary_va_name AN 255 M Nama rekening VA
5 beneficiary_bank_code N 10 M Kode Bank
6 beneficiary_bank_branch AN 255 M nama cabang bank
7 beneficiary_region_code N 4 M Kode cabang bank
8 beneficiary_country_code AN 2 M Kode Negara
9 beneficiary_purpose_code N 1 O Kode tujuan menggunakan akun sistem

Response

{
    "virtual_account": "9920000082",
    "beneficiary_account": "1020006137993",
    "beneficiary_account_name": " Faspay Collection 1",
    "beneficiary_va_name": " Faspay Collection 1",
    "beneficiary_bank_code": "008",
    "beneficiary_bank_name": "BANK MANDIRI",
    "beneficiary_bank_branch": "Mandiri KCP",
    "beneficiary_region_code" : "0102",
    "beneficiary_country_code" : "ID",
    "beneficiary_purpose_code" : "1"
    "bank_account_number": "1020006137993",
    "bank_account_name": "IN000018000680854",
    "status": "1",
    "message": "OK",
    "response_code": "00",
    "response_desc": "success"

}

*)Response :

No Parameter Type Length Mandatory/Optional Description
1 virtual_account N 20 M Virtual akun merchant
2 Beneficiary_account N 128 M Akun penerima dari VA baru merchant
3 beneficiary_account_name AN 255 M Nama akun bank
4 beneficiary_va_name AN 255 M Nama VA
5 beneficiary_bank_code N 10 M Kode bank
6 beneficiary_bank_name AN M Nama Bank
7 beneficiary_bank_branch AN 255 M Cabang Bank
8 beneficiary_region_code N 4 M Kode wilayah
9 beneficiary_country_code AN 2 M Kode negara
10 beneficiary_purpose_code N O Kode tujuan
11 bank_account_number N M Nomor akun Beneficiary
12 bank_account_name AN M Nama aku beneficiary
13 status N M List status registrasi :
1 = On Process,6 = Already Registered
14 message AN M Deskripsi pesan
15 response_code AN 2 M Kode respon dari bank (00 = success)
16 response_desc AN 32 M Respon deskripsi bank

Confirmation Register Account

Layanan ini digunakan oleh user / merchant untuk konfirmasi penambahan akun tujuan transfer dana kedalam sistem. Gunakan relative URL dibawah ini untuk generate signature :

dan juga digunakan untuk membuat signature dan menggunakan request header + request body.

Gunakan URL ini:

Path URL :

dan juga digunakan untuk membuat signature dan menggunakan request header + request body.

Sample Request

{
    "virtual_account": "9920000028",
    "beneficiary_account": "1020006137993",
    "beneficiary_account_name": "Disbursment child 1",
    "beneficiary_va_name": "Disbursment child 1",
    "beneficiary_bank_code": "008",
    "beneficiary_bank_name": "BANK MANDIRI",
    "beneficiary_bank_branch": "Mandiri KCP",
    "bank_account_number": "1020006137993",
    "bank_account_name": "IN000018000680854",
    "confirm": "2"
}

*)Request body:

No Parameter Type Length Mandatory/Optional Description
1 virtual_account N 20 M VA merchant
2 beneficiary_account N 128 M akun child
3 beneficiary_account_name AN 255 M Nama akun
4 beneficiary_va_name AN 255 M nama akun VA
5 beneficiary_bank_code N 10 M kode bank
6 beneficiary_bank_branch AN 255 M nama cabang Bank
8 beneficiary_region_code N 4 M Kode wilayah Bank
9 beneficiary_country_code AN 2 M Kode Negara
10 beneficiary_purpose_code N 1 O kode tujuan untuk menggunakan sistem akun
11 bank_account_number N M akun bank child
12 bank_account_name AN M nama akun bank
13 confirm N M kode konfirmasi, diisi dengan 2, selalu 2

Sample Response

{
    "virtual_account": "9920000028",
    "beneficiary_account": "1020006137993",
    "beneficiary_account_name": "Disbursment child 1",
    "beneficiary_va_name": "Disbursment child 1",
    "beneficiary_bank_code": "008",
    "beneficiary_bank_name": "BANK MANDIRI",
    "beneficiary_bank_branch": "Mandiri KCP",
    "beneficiary_region_code" : "0102",
    "beneficiary_country_code" : "ID",
    "beneficiary_purpose_code" : "1",
    "bank_account_number": "1020006137993",
    "bank_account_name": "IN000018000680854",
    "beneficiary_virtual_account": "9920000073",
    "status": "2",
    "message": "Success",
    "response_code": "00",
    "response_desc": "success"
}

*)Response :

No Parameter Type Length Mandatory/Optional Description
1 virtual_account N 20 M Akun virtual dari merchant
2 Beneficiary_account N 128 M Rekening penerima baru VA di bawah merchant
3 beneficiary_account_name AN 255 M Nama akun Bank
4 beneficiary_va_name AN 255 M Nama VA
5 beneficiary_bank_code N 10 M Kode Bank
6 beneficiary_bank_name AN M Nama Bank
7 beneficiary_bank_branch AN 255 M Cabang Bank
8 beneficiary_region_code N 4 M Kode wilayah
9 beneficiary_country_code AN 2 M Kode negara
10 beneficiary_purpose_code N 1 O Kode tujuan
11 bank_account_number N M Nomor akun penerima baru
12 bank_account_name AN M nama akun penerima baru
13 beneficiary_virtual_account N 20 M digunakan untuk nomor VA child / VA dibawah parent yang sudah register
14 status N M Status konfirmasi (2 = sukses)
15 message AN M Deskripsi merchant
16 response_code AN 2 M Respon kode dari Bank (00 = sukses)
17 response_desc AN 32 M Respon deskripsi dari Bank

Transfer

Layanan ini digunakan untuk melakukan proses tranfer dana dari akun merchant ke akun tujuan yang sudah didaftarkan sebelumnya. Gunakan relative URL ini untuk generate signature :

dan juga digunakan untuk membuat signature dan menggunakan request header + request body.

Sample Request body :

{  
  "virtual_account" : "9920015307",
  "beneficiary_virtual_account" : "9920015361",
  "beneficiary_account" : "10000006",
  "beneficiary_name" : "Dummy Faspay",
  "beneficiary_bank_code" : "014",
  "beneficiary_region_code" : "0391",
  "beneficiary_country_code" : "ID",
  "beneficiary_purpose_code" : "1",
  "beneficiary_email" : "priyonoagus005@gmail.com, agus.priyono@gmail.com"
  "trx_no" : "87643666",
  "trx_date" : "2020-08-25 08:51:00",
  "instruct_date" : "",
  "trx_amount" : "2500000",
  "trx_desc" : "Pengiriman Uang",
  "callback_url" : "https://dev2.faspay.co.id/account/api/callback"
}

*)Request body:

No Parameter Type Length Mandatory/Optional Description
1 virtual_account Numeric 20 Mandatory VA merchant
2 beneficiary_virtual_account Numeric 20 Mandatory Nomor Akun VA penerima
3 beneficiary_account Numeric 128 Mandatory Nomor akun VA
4 beneficiary_name Alfanumeric 255 Mandatory Nama akun
5 beneficiary_bank_code Numeric 3 Mandatory Kode bank penerima
6 beneficiary_region_code Numeric 4 Mandatory Kode cabang bank penerima
7 beneficiary_country_code Alfanumeric 2 Mandatory Kode negara penerima
8 beneficiary_purpose_code Numeric 1 Mandatory Kode tujuan dalam menggunakan akun
9 beneficiary_email Alfanumeric 255 Optional Email penerima
Note : email bisa diisi lebih dari 1 dengan memasukkan separator “,” untuk pemisah
10 trx_no Alfanumeric 255 Mandatory Nomor transaksi dari merchant.
11 trx_date Datetime Mandatory datetime (Y-m-d H:i:s)
12 instruct_date Datetime Mandatory Tanggal instruksi transfer
- Null : transaksi realtime
- Datetime : contoh 2018-12-21 08:30:00, transaksi akan dikirim tgl 2018-12-21 08:30:00
13 trx_amount Numeric Mandatory Total nilai, ex : 10.000 -> 1000000
Format penulisan tidak diperbolehkan desimal, hanya diperbolehkan bilangan bulat (integer)
14 trx_desc Alfanumeric 15 Optional Deskripsi, jika user menulis lebih dari 15 karakter, maka akan otomatis dijadikan tidak lebih dari 15 karakter.
15 callback_url Alfanumeric 255 Mandatory URL untuk callback / notification, digunakan untuk mengirimkan notifikasi ke merchant.

Response

{
    "virtual_account": "9920015307",
    "beneficiary_virtual_account": "9920015361",
    "beneficiary_account": "10000006",
    "beneficiary_name": "DummyFaspay",
    "beneficiary_bank_code": "014",
    "beneficiary_region_code": "0391",
    "beneficiary_country_code": "ID",
    "beneficiary_purpose_code": "1",
    "beneficiary_email" : "priyonoagus005@gmail.com, agus.priyono@gmail.com"
    "trx_no": "87643666",
    "trx_date": "2020-08-25 08:51:00",
    "instruct_date": "",
    "trx_amount": 2500000,
    "trx_desc": "Pengiriman Uang",
    "callback_url": "https://dev2.faspay.co.id/account/api/callback",
    "trx_id": 6411,
    "trx_reff": "O4wgHmwglqpFAv-hZiu-_9999980300009258",
    "status": "1",
    "message": "On Process",
    "response_code": "00",
    "response_desc": "success"
}

*)Response body:

No Parameter Type Length Mandatory/Optional Description
1 virtual_account Numeric 20 Mandatory VA merchant
2 beneficiary_virtual_account Numeric 20 Mandatory Nomor akun VA penerima
3 beneficiary_account Numeric 128 Mandatory Akun penerima
4 beneficiary_name Alfanumeric 255 Mandatory Nama penerima
5 beneficiary_bank_code Numeric 3 Mandatory Kode bank penerima
6 beneficiary_region_code Numeric 4 Mandatory Kode cabang bank penerima
7 beneficiary_country_code Alfanumeric 2 Mandatory Kode negara penerima
8 beneficiary_purpose_code Numeric 1 Mandatory Kode tujuan dalam menggunakan akun
9 beneficiary_email Alfanumeric 255 Optional Email penerima
Note : email bisa diisi lebih dari 1 dengan memasukkan separator “,” untuk pemisah
10 trx_no Alfanumeric 255 Mandatory Nomor transaksi dari merchant
11 trx_date Datetime Mandatory datetime (Y-m-d H:i:s)
12 instruct_date Datetime Mandatory Tanggal instruksi transfer
13 trx_amount Numeric Mandatory Total nilai, ex : 10.000 -> 1000000
Format penulisan angka tidak diperbolehkan desimal, hanya diperbolehkan bilangan bulat (integer)
14 trx_desc Alfanumeric Mandatory Deskripsi Transaksi
15 callback_url Alfanumeric 255 Optional URL for callback / notification, digunakan jika merchant ingin sistem untuk mengirimkan notifikasi ke merchant
16 trx_id Numeric Mandatory Id transaksi
17 trx_reff Alfanumeric 128 Mandatory Nomor referensi transaksi sistem disbursement
18 status Numeric Mandatory Daftar status transaksi : 1 = On Process, 2 = Success, 4 = Failed, 5 = Reverse
19 message Alfanumeric Mandatory Deskripsi pesan
20 response_code Alfanumeric 2 Mandatory Kode respon dari bank (00 = success)
21 response_desc Alfanumeric 32 Mandatory Deskripsi respon dari bank

Inquiry Name

Layanan ini digunakan oleh user / merchant untuk pengecekan(inquiry) data nama pemilik rekening yang didaftarkan. Gunakan relative URL ini untuk generate signature :

dan juga digunakan untuk membuat signature dan menggunakan request header.

Sample Response

{
    "virtual_account": "9920000028",
    "beneficiary_virtual_account": "9920000073",
    "beneficiary_account_number": "1020006137993",
    "beneficiary_account_name": "IN000018000680854",
    "status": "2",
    "message": "Success",
    "response_code": "00",
    "response_desc": "success"
}

*)Response body:

No Parameter Type Length Mandatory/Optional Description
1 virtual_account N 20 M VA Merchant
2 beneficiary_virtual_account AN M Nomor akun VA penerima
2 beneficiary_account_number N M Nomor akun bank
3 beneficiary_account_name AN 255 M Nama akun bank
6 status N M Status inquiry (2 = success)
7 message AN M Deskripsi pesan
8 response_code N 2 M Kode respon dari bank (00 = success)
9 response_desc AN 32 M Deskripsi respon dari bank

Inquiry Balance

Layanan ini digunakan untuk memeriksa atau melihat sisa dana dari akun user / merchant terdaftar yang masih ada di sistem disbursement. Gunakan relative URL ini untuk generate signature :

dan juga digunakan untuk membuat signature dan menggunakan request header.

Sample Response

{
    "virtual_account": "9920000028",
    "balance": "7897000.00",
    "available_balance": "6897000.00",
    "status": "2",
    "message": "Success",
    "response_code": "00",
    "response_desc": "success"
}

*)Response body:

No Parameter Type Length Mandatory/Optional Description
1 virtual_account N M VA merchant
2 balance AN M Jumlah saldo
2 Available_balance N M Jumlah saldo yang tersedia untuk transaksi
6 status N M Status inquiry (2 = success)
7 message AN M Deskripsi pesan
8 response_code N 2 M Kode respon dari bank (00 = success)
9 response_desc AN 32 M Deskripsi respon dari bank

Mutasi

Layanan ini digunakan oleh user / merchant untuk memeriksa data mutasi rekening yang terdaftar di sistem disbursement. Gunakan relative URL ini untuk generate signature :

dan juga digunakan untuk membuat signature dan menggunakan request header.

Sample Response

{    
    "virtual_account": "9920015307",
    "start_date": "2019-02-01",
    "end_date": "2019-02-12",
    "data": [
        {
            "transaction_date": "11/02/2019 16:48:11",
            "transaction_type": "K",
            "transaction_amount": "10000000.00",
            "transaction_name": "topup",
            "transaction_desc": "Topup Saldo #8985929920015307 99992417885"
        },
        {
            "transaction_date": "12/02/2019 08:51:00",
            "transaction_type": "D",
            "transaction_amount": "25000.00",
            "transaction_name": "transfer",
            "transaction_desc": "Test 9920015361 O4wgHmwglqpFAv-hZiu-"
        }
    ],
    "status": "2",
    "message": "Success",
    "response_code": "00",
    "response_desc": "success"
}

*)Response body:

No Parameter Type Length Mandatory/Optional Description
1 virtual_account N M VA merchant
2 Start_date N M Tanggal mulai mutasi
3 End_date N M Tanggal akhir mutasi
4 Transaction_date N M Tanggal transaksi
5 Transaction_type AN M Jenis transaksi (Debit / Credit)
6 Transaction_amount N M Jumlah dari transaksi
7 Transaction_name AN M Nama referensi transaksi
8 Transaction_desc AN M Deskripsi transaksi
9 Status M Status = 2
10 Message M Deskripsi pesan
11 Response_code M Kode respon
12 Response_desc M Deskripsi respon

Inquiry Status

Layanan ini digunakan untuk melakukan pengecekan status pembayaran / status transfer dana yang dilakukan user / merchant ke akun penerima transfer dananya. Gunakan URL relatif ini untuk generate signature

dan juga digunakan untuk membuat signature dan menggunakan request header.

Sample Response

{
    "virtual_account": "9920015307",
    "beneficiary_virtual_account": "9920015361",
    "beneficiary_account": "10000006",
    "beneficiary_name": "DummyFaspay",
    "beneficiary_bank_code": "008",
    "beneficiary_bank_name": "2019-02-12 08:51:24.4970000",
    "trx_id": "6411",
    "trx_no": "87643666",
    "trx_date": "2019-02-12 08:51:00",
    "trx_amount": 2500000,
    "trx_desc": "Test",
    "trx_reff": "O4wgHmwglqpFAv-hZiu-_9999980300009258",
    "callback_url": "https://dev2.faspay.co.id/account/api/callback",
    "trx_status_date": "2019-02-12 08:51:52",
    "status": "2",
    "message": "Success",
    "response_code": "00",
    "response_desc": "success"
}

*)Response body:

No Parameter Type Length Mandatory/Optional Description
1 virtual_account N M VA merchant
2 beneficiary_virtual_account N 20 M Nomor akun VA penerima
3 beneficiary_account N 128 M Nomor akun penerima
4 beneficiary_name AN 255 O Nama Akun penerima
5 beneficiary_bank_code N 3 M Kode bank penerima
6 beneficiary_bank_name AN 128 M Nama bank penerima
7 trx_id N M Id transaksi
8 trx_no AN 255 M Nomor transaksi dari merchant
9 trx_date Datetime M datetime (Y-m-d H:i:s)
10 trx_amount N M Total nilai, ex : 10.000 -> 1000000
11 trx_desc AN M Deskripsi
12 trx_reff AN 128 M Nomor referensi transaksi sistem disbursement
13 callback_url AN 255 O URL untuk callback / notification, digunakan jika merchant ingin sistem untuk mengirimkan notifikasi ke merchant
14 trx_status_date Datetime M Tanggal transaksi sukses, format datetime (Y-m-d H:i:s)
15 bank_response_code N 2 M Kode respon dari bank
16 bank_response_msg AN 32 M Pesan respon dari bank
17 status N 1 M Status transaksi :
1 = On Process
2 = Success
4 = Failed
5 = Reverse
18 message AN 32 M Info status transaksi
19 response_code N 2 M Kode respon dari bank (00 = success)
20 response_desc AN 32 M Deskripsi respon dari bank

API Services Cash Out

Layanan Cash Out merupakan salah satu fitur dari Faspay SendMe yang digunakan customer untuk penarikan uang tunai / dana, namun sebelum customer dapat melakukan penarikan uang, customer wajib mendapatkan nomor kode cash out yang didapatkan dari merchant terlebih dahulu.

Kode Payment Channel
823 Alfamart Cash Out

Flow Transaction Alfamart Cash Out (823)

Image of SendMe

Flow Transaction Alfamart Cash Out

Flow Reversal

Image of SendMe

Flow Reversal Alfamart Cash Out

Reversal dilakukan otomatis di sisi Server Alfamart dan akan dikirimkan sebanyak maksimal 3 kali, jika reversal sebelumnya masih tidak mendapatkan response, maka akan dilakukan reversal dimenit berikutnya. Nantinya Faspay akan mengirimkan notification ke sisi merchant untuk memberitahukan bahwa transaksi yang dilakukan mengalami reversal.

Transfer

Layanan ini berfungsi untuk create transaksi dari merchant ke Faspay yang kemudian digunakan untuk melakukan proses tranfer dana dari akun merchant ke akun tujuan yang sudah didaftarkan sebelumnya. Gunakan relative URL ini untuk generate signature :

dan juga digunakan untuk membuat signature dan menggunakan request header + request body.

Request Transfer

Sample Request body :

{
    "virtual_account":"9920017573",
    "beneficiary_bank_code":"alf",
    "beneficiary_region_code":"0391",
    "beneficiary_country_code":"ID",
    "beneficiary_purpose_code":"1",
    "beneficiary_phone":"08906534212",
    "beneficiary_email":"ulin.nuha@faspay.co.id",
    "trx_no":"431440034568",
    "trx_date":"2020-10-13 14:16:00",
    "instruct_date":"",
    "trx_amount":"2500000",
    "trx_desc":"CashOut Alfamart",
    "callback_url":"https://dev2.faspay.co.id/account/api/callback",
    "ktp_id":"0123456449105144",
    "place_of_birth":"Jakarta",
    "date_of_birth":"1990-06-21",
    "gender":"F",
    "citizenship":"WNI",
    "occupation":"Employee",
    "trx_expired":"",
    "address":"jln pintu air Raya",
    "beneficiary_account_name":"Ulin Nuha"
    }
  

Parameter-parameter yang harus disediakan oleh sistem merchant untuk dapat integrasi dengan sistem Faspay:

*)Request body:

No Parameter Type Length Mandatory/Optional Description
1 virtual_account N 20 M VA merchant
2 beneficiary_bank_code AN 3 M Kode Bank penerima
3 beneficiary_region_code N 4 M Kode cabang bank penerima
4 beneficiary_country_code AN 2 M Kode negara penerima
5 beneficiary_purpose_code N 1 M Kode tujuan dalam menggunakan akun
6 beneficiary_phone AN 15 M Nomor handphone penerima
7 beneficiary_email AN 128 M Email Penerima
8 trx_no N 12 M Nomor transaksi dari merchant
10 trx_date Datetime M datetime (Y-m-d H:i:s)
11 instruct_date Datetime M Tanggal instruksi transfer
12 trx_amount N M Total nilai, ex : 10.000 -> 1000000
13 trx_desc AN M Deskripsi
14 callback_url AN 255 O URL for callback / notification, digunakan jika merchant ingin sistem untuk mengirimkan notifikasi ke merchant
15 ktp_id N 16 M ID KTP
16 place_of_birth AN 255 M Tempat tanggal lahir
17 date_of_birth Datetime M Tanggal lahir
18 gender AN 2 M Jenis Kelamin
19 citizenship AN 3 M Kewarganegaraan
20 occupation AN 255 M Pekerjaan
21 trx_expired Datetime O Transaksi kadaluarsa, -null : maka expired date akan terhitung dalam waktu 24 jam (tergantung merchant)
22 address AN 255 M Alamat
23 beneficiary_account_name AN M Nama Rekening Penerima

Response Transfer

Response

{
    "virtual_account":"9920017573",
    "beneficiary_bank_code":"alf",
    "beneficiary_region_code":"0391",
    "beneficiary_country_code":"ID",
    "beneficiary_purpose_code":"1",
    "beneficiary_phone":"08906534212",
    "beneficiary_email":"ulin.nuha@faspay.co.id",
    "trx_no":"431440034568",
    "trx_date":"2020-10-13 14:16:00",
    "instruct_date":"",
    "trx_amount":"2500000",
    "trx_desc":"CashOut Alfa",
    "callback_ur":"https://dev2.faspay.co.id/account/api/callback",
    "ktp_id":"0123456449105144",
    "place_of_birth":"Jakarta",
    "date_of_birth":"1990-06-21",
    "gender":"F",
    "citizenship":"WNI",
    "occupation":"Employee",
    "trx_expired":"",
    "address":"jln pintu air Raya",
    "beneficiary_account_name":"Ulin Nuha",
    "trx_id":"1993275",
    "trx_reff":"aIvEmfwvo25RHfCXoNeU_9999982300002485",
    "cashout_code":"9999982300002485",
    "status":"1",
    "message":"On Process",
    "response_code":"00",
    "response_desc":"success"
    }
  

*)Response body:

No Parameter Type Length Mandatory/Optional Description
1 virtual_account N 20 M VA merchant
2 beneficiary_bank_code AN 3 M Kode bank penerima
3 beneficiary_region_code N 4 M Kode cabang bank penerima
4 beneficiary_country_code AN 2 M Kode negara penerima
5 beneficiary_purpose_code N 1 M Kode tujuan dalam menggunakan akun
6 beneficiary_phone AN 15 M Nomor handphone penerima
7 beneficiary_email AN 128 M Email penerima
8 trx_no N 12 M Nomor transaksi dari merchant
10 trx_date Datetime M datetime (Y-m-d H:i:s)
11 instruct_date Datetime M Tanggal instruksi transfer
12 trx_amount N M Total nilai, ex : 10.000 -> 1000000
13 trx_desc AN M Deskripsi
14 callback_url AN 255 O URL for callback / notification, digunakan jika merchant ingin sistem untuk mengirimkan notifikasi ke merchant
15 ktp_id N 16 M ID KTP
16 place_of_birth AN 255 M Tempat tanggal lahir
17 date_of_birth Datetime M Tanggal lahir
18 gender AN 2 M Jenis kelamin
19 citizenship AN 3 M Kewarganegaraan
20 occupation AN 255 M Pekerjaan
21 trx_expired Datetime O Transaksi kadaluarsa, -null : maka expired date akan terhitung dalam waktu 24 jam (tergantung merchant)
22 address AN 255 M Alamat
23 beneficiary_account_name AN M Nama rekening penerima
24 trx_id N M ID Transaksi
25 trx_reff AN M Nomor referensi transaksi
26 cashout_code N 16 M Kode Cash Out
27 status N 1 M Daftar status transaksi : 1 = On Process, 2 = Success, 4 = Failed, 5 = Reverse
28 message AN M Deskripsi pesan
29 response_code N 2 M Kode respon dari bank (00 = success)
30 response_desc AN M Deskripsi respon dari bank

Notification / Callback

Digunakan oleh merchant untuk menerima notifikasi transaksi dari sistem disbursement Faspay. Jika terdapat transaksi transfer dana atau pencairan dana, sistem akan mengirimkan notifikasi tersebut ke merchant melalui URL yang dikirimkan pada saat proses transaksi / pencairan dana.

Url Notification : [disiapkan oleh Merchant]

Generate Signature Notification

Requirement

1. app_key

2. app_secret

3. client_id

4. client_secret

5. Request Body From Faspay

6. Request Method From Faspay

Generate

1. Request Body From Faspay :

- Hapus karakter '\r', '\n', '\t' dan spasi - Hashing dengan algoritma sha256 - Ubah ke huruf Kapital (UPPERCASE)

2. Faspay Authorization : base64_encode(client_id:client_secret)

3. StringToSign : "[api_key]:[Request Method From Faspay]:[Faspay Authorization]:[Request Body From Faspay]"

*) tanpa [] dan ""

4. Signature : SHA-256 HMAC (StringToSign, api_secret)

Sample Request Notification

{  
   "request":"Notification",
   "virtual_account":"9920000153",
   "va_name":"Aselole",
   "beneficiary_virtual_account":"9920000206",
   "beneficiary_account":"1020006137993",
   "beneficiary_name":"NQUSWV TPVNTUX QKSLNNZNOT",
   "trx_id":"1064620",
   "trx_date":"2018-09-18 14:53:00.0000000",
   "trx_amount":"15000",
   "trx_desc":"Cashout disb",
   "trx_status":"2",
   "trx_status_date":"2018-09-18 16:19:02.7059190",
   "trx_reff":"9999980500003798",
   "trx_no":"3140815927999298410",
   "bank_code":"008",
   "bank_name":"BANK MANDIRI",
   "bank_response_code":"2",
   "bank_response_msg":"Payment Sukses",
   "signature":"e3350052919bfef6a436110988265508aa5738898383a4bae4d4cb4e3575cf27"
}

*)Request body:

No Parameter Type Length Mandatory/Optional Description
1 request AN M Deskripsi permintaan
2 virtual_account N M VA Pengirim
3 va_name AN M Nama VA Pengirim
4 beneficiary_virtual_account N M Nomor VA Penerima
5 beneficiary_account AN M Nomor Rekening Penerima
6 beneficiary_name AN M Nama Rekening Penerima
7 trx_id AN M Id Transaksi
8 trx_date Datetime M datetime (Y-m-d H:i:s)
9 trx_amount AN M Total Nilai, ex : 10.000 -> 1000000
10 trx_desc AN M Deskripsi
11 trx_status N M Daftar Status Transaksi :
1 = On Process, 2 = Success, 4 = Failed, 5 = Reverse
12 trx_status_date Datetime M Tanggal Transaksi Sukses, Format Datetime (Y-m-d H:i:s)
13 trx_reff AN M Referensi dari Sistem
14 trx_no AN 255 M Nomor Transaksi dari Merchant
15 bank_code N M Kode Bank VA Penerima
16 bank_name AN M Nama Bank Penerima
17 bank_response_code N M Respon Transaksi dari Bank
2 = Transaction Success, 3 = Transaction Reversal / Transaction Expired
18 bank_response_msg AN M Respon Pesan dari Bank
19 signature AN M *) Mengacu ke Dokumentasi generate signature

Response Body

{  
   "response":"Notification",
   "virtual_account":"9920000153",
   "beneficiary_virtual_account":"9920000206",
   "bank_code":"008",
   "bank_name":"BANK MANDIRI",
   "response_code":"00",
   "response_desc":"Success"
}

*)Response body:

No Parameter Type Length Mandatory/Optional Description
1 response AN M Deskripsi Respon
2 virtual_account N M VA Transaksi pengirim
3 beneficiary_virtual_account N M Nomor VA penerima
4 bank_code N M Kode bank VA penerima
5 bank_name AN M Nama bank
6 response_code N M Daftar respon : 00 = Success, 01 = Failed
7 response_desc AN M Description respon

APPENDIX

Berikut kami lampirkan daftar Bank Code, Region Code, Country Code dan Purpose Code. Untuk mengunduh lampiran silahkan klik tautan ini LAMPIRAN

Account Testing

Account testing ini digunakan untuk melakukan testing di server development.

Changelog

Version 1.0

11 Juli 2017

Version 1.1

27 Juli 2017

04 September 2017

Version 1.2

05 Oktober 2017

Version 1.3

12 Oktober 2017

16 Oktober 2017

18 Desember 2017

Version 1.4

26 Maret 2018

Version 1.5

18 Juli 2018

Version 1.6

30 November 2018

Version 1.7

07 Desember 2018

Version 1.8

11 Mei 2020

Version 1.9

15 Juni 2020

23 Juni 2020

Version 1.10

14 Juli 2020

Version 1.11

14 Agustus 2020

Version 1.12

25 August 2020

03 September 2020

Version 1.13

09 September 2020

Version 1.14

16 October 2020

Version 1.15

04 December 2020