# Bank Transfer Integration Guide One of the payment methods offered by Faspay is a Bank Transfer/Virtual Account. By using this payment method, customers will have the option to make a payment via bank transfer and Faspay will send real-time notifications when the customer completes the payment. At this moment, Faspay has integrated with the following bank transfer payment methods: 1. Permata Virtual Account 2. BCA Virtual Account 3. Mandiri Virtual Account 4. Maybank Virtual Account 5. BRI Virtual Account 6. BNI Virtual Account 7. BSI Virtual Account 8. Sinarmas Virtual Account 9. Danamon Virtual Account 10. CIMB Virtual Account The basic integration process of Bank Transfer/Virtual Account will be explained below. ## **Integration Step** 1. Post Data Transaction to Faspay 2. Display Virtual Account 3. Payment Notification ### 1. Post Data Transaction Post data transactions should be done from the merchant backend, the detailed API reference can be found [here](https://docs.faspay.co.id/merchant-integration/api-reference-1/debit-transaction/post-data-transaction) {% hint style="info" %} Every Bank Transfer/Virtual Account channel will use the same API request, the difference is only on payment\_channel value for each Bank Transfer/Virtual Account {% endhint %} This is an example of post data transaction for a Bank transfer/Virtual Account channel {% tabs %} {% tab title="Permata" %} ```json { "request": "Post Data Transaction", "merchant_id": "99999", "merchant": "Sophia Store", "bill_no": "20201222101218", "bill_reff": "20200324_02-2286704_336", "bill_date": "2020-12-19 06:04:29", "bill_expired": "2020-12-19 07:04:29", "bill_desc": "Payment Online Via Faspay", "bill_currency": "IDR", "bill_gross": "100000", "bill_miscfee": "100000", "bill_total": "200000", "cust_no": "01", "cust_name": "John Doe", "payment_channel": "402", "pay_type": "01", "msisdn": "8562927907", "email": "john@gmail.com", "terminal": "10", "billing_address": "Jl Sabang 37", "billing_address_city": "Jakarta", "billing_address_region": "DKI Jakarta", "billing_address_state": "Indonesia", "billing_address_poscode": "10170", "billing_address_country_code": "ID", "receiver_name_for_shipping": "John Doe", "shipping_address": "Jl. Sabang 37", "shipping_address_city": "Jakarta", "shipping_address_region": "DKI Jakarta", "shipping_address_state": "Indonesia", "shipping_address_poscode": "10170", "item": { "id": "A001", "product": "Invoice #2286704", "qty": "1", "amount": "100000", "payment_plan": "01", "merchant_id":"99999", "tenor": "00" }, "reserve1": "", "reserve2": "", "signature": "3af2a967a7bf809b651777e376ce81bc20dea249" } ``` {% endtab %} {% tab title="BCA" %} ```json { "request": "Post Data Transaction", "merchant_id": "99999", "merchant": "Sophia Store", "bill_no": "20201222103305", "bill_reff": "20200324_02-2286704_336", "bill_date": "2020-12-19 06:04:29", "bill_expired": "2020-12-19 07:04:29", "bill_desc": "Payment Online Via Faspay", "bill_currency": "IDR", "bill_gross": "100000", "bill_miscfee": "100000", "bill_total": "200000", "cust_no": "01", "cust_name": "John Doe", "payment_channel": "702", "pay_type": "01", "msisdn": "8562927907", "email": "john@gmail.com", "terminal": "10", "billing_address": "Jl Sabang 37", "billing_address_city": "Jakarta", "billing_address_region": "DKI Jakarta", "billing_address_state": "Indonesia", "billing_address_poscode": "10170", "billing_address_country_code": "ID", "receiver_name_for_shipping": "John Doe", "shipping_address": "Jl. Sabang 37", "shipping_address_city": "Jakarta", "shipping_address_region": "DKI Jakarta", "shipping_address_state": "Indonesia", "shipping_address_poscode": "10170", "item": { "id": "A001", "product": "Invoice #2286704", "qty": "1", "amount": "100000", "payment_plan": "01", "merchant_id":"99999", "tenor": "00" }, "reserve1": "Free Text Payment", "reserve2": "Free Text Inquiry", "signature": "312c66286d722742c8feb730954a0eb95b96c5b4" } ``` {% endtab %} {% tab title="Mandiri" %} ```json { "request": "Post Data Transaction", "merchant_id": "99999", "merchant": "Sophia Store", "bill_no": "20201222103433", "bill_reff": "20200324_02-2286704_336", "bill_date": "2020-12-19 06:04:29", "bill_expired": "2020-12-19 07:04:29", "bill_desc": "Payment Online Via Faspay", "bill_currency": "IDR", "bill_gross": "100000", "bill_miscfee": "100000", "bill_total": "200000", "cust_no": "01", "cust_name": "John Doe", "payment_channel": "802", "pay_type": "01", "msisdn": "8562927907", "email": "john@gmail.com", "terminal": "10", "billing_address": "Jl Sabang 37", "billing_address_city": "Jakarta", "billing_address_region": "DKI Jakarta", "billing_address_state": "Indonesia", "billing_address_poscode": "10170", "billing_address_country_code": "ID", "receiver_name_for_shipping": "John Doe", "shipping_address": "Jl. Sabang 37", "shipping_address_city": "Jakarta", "shipping_address_region": "DKI Jakarta", "shipping_address_state": "Indonesia", "shipping_address_poscode": "10170", "item": { "id": "A001", "product": "Invoice #2286704", "qty": "1", "amount": "100000", "payment_plan": "01", "merchant_id":"99999", "tenor": "00" }, "reserve1": "", "reserve2": "", "signature": "c64206f9af79193123b6b4e4b72a81951aafe4c3" } ``` {% endtab %} {% tab title="Maybank" %} ```json { "request": "Post Data Transaction", "merchant_id": "99999", "merchant": "Sophia Store", "bill_no": "20201222103549", "bill_reff": "20200324_02-2286704_336", "bill_date": "2020-12-19 06:04:29", "bill_expired": "2020-12-19 07:04:29", "bill_desc": "Payment Online Via Faspay", "bill_currency": "IDR", "bill_gross": "100000", "bill_miscfee": "100000", "bill_total": "200000", "cust_no": "01", "cust_name": "John Doe", "payment_channel": "408", "pay_type": "01", "msisdn": "8562927907", "email": "john@gmail.com", "terminal": "10", "billing_address": "Jl Sabang 37", "billing_address_city": "Jakarta", "billing_address_region": "DKI Jakarta", "billing_address_state": "Indonesia", "billing_address_poscode": "10170", "billing_address_country_code": "ID", "receiver_name_for_shipping": "John Doe", "shipping_address": "Jl. Sabang 37", "shipping_address_city": "Jakarta", "shipping_address_region": "DKI Jakarta", "shipping_address_state": "Indonesia", "shipping_address_poscode": "10170", "item": { "id": "A001", "product": "Invoice #2286704", "qty": "1", "amount": "100000", "payment_plan": "01", "merchant_id":"99999", "tenor": "00" }, "reserve1": "", "reserve2": "", "signature": "7ad65e5229511e39159211731978c0777ba0665b" } ``` {% endtab %} {% tab title="BRI" %} ```json { "request": "Post Data Transaction", "merchant_id": "99999", "merchant": "Sophia Store", "bill_no": "20201222104021", "bill_reff": "20200324_02-2286704_336", "bill_date": "2020-12-19 06:04:29", "bill_expired": "2020-12-19 07:04:29", "bill_desc": "Payment Online Via Faspay", "bill_currency": "IDR", "bill_gross": "100000", "bill_miscfee": "100000", "bill_total": "200000", "cust_no": "01", "cust_name": "John Doe", "payment_channel": "800", "pay_type": "01", "msisdn": "8562927907", "email": "john@gmail.com", "terminal": "10", "billing_address": "Jl Sabang 37", "billing_address_city": "Jakarta", "billing_address_region": "DKI Jakarta", "billing_address_state": "Indonesia", "billing_address_poscode": "10170", "billing_address_country_code": "ID", "receiver_name_for_shipping": "John Doe", "shipping_address": "Jl. Sabang 37", "shipping_address_city": "Jakarta", "shipping_address_region": "DKI Jakarta", "shipping_address_state": "Indonesia", "shipping_address_poscode": "10170", "item": { "id": "A001", "product": "Invoice #2286704", "qty": "1", "amount": "100000", "payment_plan": "01", "merchant_id":"99999", "tenor": "00" }, "reserve1": "", "reserve2": "", "signature": "972f9dbceffbaf19e5dabcdd3b590532431d905a" } ``` {% endtab %} {% tab title="BNI" %} ```json { "request": "Post Data Transaction", "merchant_id": "99999", "merchant": "Sophia Store", "bill_no": "20201222104205", "bill_reff": "20200324_02-2286704_336", "bill_date": "2020-12-19 06:04:29", "bill_expired": "2020-12-19 07:04:29", "bill_desc": "Payment Online Via Faspay", "bill_currency": "IDR", "bill_gross": "100000", "bill_miscfee": "100000", "bill_total": "200000", "cust_no": "01", "cust_name": "John Doe", "payment_channel": "801", "pay_type": "01", "msisdn": "8562927907", "email": "john@gmail.com", "terminal": "10", "billing_address": "Jl Sabang 37", "billing_address_city": "Jakarta", "billing_address_region": "DKI Jakarta", "billing_address_state": "Indonesia", "billing_address_poscode": "10170", "billing_address_country_code": "ID", "receiver_name_for_shipping": "John Doe", "shipping_address": "Jl. Sabang 37", "shipping_address_city": "Jakarta", "shipping_address_region": "DKI Jakarta", "shipping_address_state": "Indonesia", "shipping_address_poscode": "10170", "item": { "id": "A001", "product": "Invoice #2286704", "qty": "1", "amount": "100000", "payment_plan": "01", "merchant_id":"99999", "tenor": "00" }, "reserve1": "", "reserve2": "", "signature": "fc6804bcb3d86253145c8a35d727b1a5b3727500" } ``` {% endtab %} {% tab title="Sinarmas" %} ```json { "request": "Post Data Transaction", "merchant_id": "99999", "merchant": "Sophia Store", "bill_no": "20201222104353", "bill_reff": "20200324_02-2286704_336", "bill_date": "2020-12-19 06:04:29", "bill_expired": "2020-12-19 07:04:29", "bill_desc": "Payment Online Via Faspay", "bill_currency": "IDR", "bill_gross": "100000", "bill_miscfee": "100000", "bill_total": "200000", "cust_no": "01", "cust_name": "John Doe", "payment_channel": "818", "pay_type": "01", "msisdn": "8562927907", "email": "john@gmail.com", "terminal": "10", "billing_address": "Jl Sabang 37", "billing_address_city": "Jakarta", "billing_address_region": "DKI Jakarta", "billing_address_state": "Indonesia", "billing_address_poscode": "10170", "billing_address_country_code": "ID", "receiver_name_for_shipping": "John Doe", "shipping_address": "Jl. Sabang 37", "shipping_address_city": "Jakarta", "shipping_address_region": "DKI Jakarta", "shipping_address_state": "Indonesia", "shipping_address_poscode": "10170", "item": { "id": "A001", "product": "Invoice #2286704", "qty": "1", "amount": "100000", "payment_plan": "01", "merchant_id":"99999", "tenor": "00" }, "reserve1": "", "reserve2": "", "signature": "131693f2bbb87bca4b73d1df4dfc6e45f626ec96" } ``` {% endtab %} {% tab title="Danamon" %} ```json { "request": "Post Data Transaction", "merchant_id": "99999", "merchant": "Sophia Store", "bill_no": "20201222104527", "bill_reff": "20200324_02-2286704_336", "bill_date": "2020-12-19 06:04:29", "bill_expired": "2020-12-19 07:04:29", "bill_desc": "Payment Online Via Faspay", "bill_currency": "IDR", "bill_gross": "100000", "bill_miscfee": "100000", "bill_total": "200000", "cust_no": "01", "cust_name": "John Doe", "payment_channel": "708", "pay_type": "01", "msisdn": "8562927907", "email": "john@gmail.com", "terminal": "10", "billing_address": "Jl Sabang 37", "billing_address_city": "Jakarta", "billing_address_region": "DKI Jakarta", "billing_address_state": "Indonesia", "billing_address_poscode": "10170", "billing_address_country_code": "ID", "receiver_name_for_shipping": "John Doe", "shipping_address": "Jl. Sabang 37", "shipping_address_city": "Jakarta", "shipping_address_region": "DKI Jakarta", "shipping_address_state": "Indonesia", "shipping_address_poscode": "10170", "item": { "id": "A001", "product": "Invoice #2286704", "qty": "1", "amount": "100000", "payment_plan": "01", "merchant_id":"99999", "tenor": "00" }, "reserve1": "", "reserve2": "", "signature": "4265a719713828fb1927653fb33b3edde811798d" } ``` {% endtab %} {% tab title="CIMB" %} ```json { "request": "Post Data Transaction", "merchant_id": "99999", "merchant": "Sophia Store", "bill_no": "20201222104717", "bill_reff": "20200324_02-2286704_336", "bill_date": "2020-12-19 06:04:29", "bill_expired": "2020-12-19 07:04:29", "bill_desc": "Payment Online Via Faspay", "bill_currency": "IDR", "bill_gross": "100000", "bill_miscfee": "100000", "bill_total": "200000", "cust_no": "01", "cust_name": "John Doe", "payment_channel": "825", "pay_type": "01", "msisdn": "8562927907", "email": "john@gmail.com", "terminal": "10", "billing_address": "Jl Sabang 37", "billing_address_city": "Jakarta", "billing_address_region": "DKI Jakarta", "billing_address_state": "Indonesia", "billing_address_poscode": "10170", "billing_address_country_code": "ID", "receiver_name_for_shipping": "John Doe", "shipping_address": "Jl. Sabang 37", "shipping_address_city": "Jakarta", "shipping_address_region": "DKI Jakarta", "shipping_address_state": "Indonesia", "shipping_address_poscode": "10170", "item": { "id": "A001", "product": "Invoice #2286704", "qty": "1", "amount": "100000", "payment_plan": "01", "merchant_id":"99999", "tenor": "00" }, "reserve1": "", "reserve2": "", "signature": "789fb3cbd4dd9e6be750647e71add5cd95288f4a" } ``` {% endtab %} {% endtabs %} **Post Data Transaction Response** You will get the post data response like the following {% tabs %} {% tab title="Permata" %} ```json { "response": "Transmission of Purchase Detail Info", "trx_id": "7178990000218842", "merchant_id": "99999", "merchant": "Sophia Store", "bill_no": "20201222103305", "bill_items": { "id": "A001", "product": "Invoice #2286704", "qty": "1", "amount": "100000", "payment_plan": "01", "merchant_id": "99999", "tenor": "00" }, "response_code": "00", "response_desc": "Success", "redirect_url": "https://dev.faspay.co.id/pws/100003/0830000010100000/3af2a967a7bf809b651777e376ce81bc20dea249?trx_id=7178990000218842&merchant_id=99999&bill_no=20201222103305" } ``` {% endtab %} {% tab title="BCA" %} ```json { "response": "Transmission of Purchase Detail Info", "trx_id": "9999970200014480", "merchant_id": "99999", "merchant": "Sophia Store", "bill_no": "20201222101845", "bill_items": { "id": "A001", "product": "Invoice #2286704", "qty": "1", "amount": "100000", "payment_plan": "01", "merchant_id": "-", "tenor": "00" }, "response_code": "00", "response_desc": "Success", "https://dev.faspay.co.id/pws/100003/0830000010100000/312c66286d722742c8feb730954a0eb95b96c5b4?trx_id=9999970200014480&merchant_id=99999&bill_no=20201222101845" } ``` {% endtab %} {% tab title="Mandiri" %} ```json { "response": "Transmission of Purchase Detail Info", "trx_id": "8855899000083832", "merchant_id": "99999", "merchant": "Sophia Store", "bill_no": "20201222103433", "bill_items": { "id": "A001", "product": "Invoice #2286704", "qty": "1", "amount": "100000", "payment_plan": "01", "merchant_id": "-", "tenor": "00" }, "response_code": "00", "response_desc": "Success", "redirect_url": "https://dev.faspay.co.id/pws/100003/0830000010100000/c64206f9af79193123b6b4e4b72a81951aafe4c3?trx_id=8855899000083832&merchant_id=99999&bill_no=20201222103433" } ``` {% endtab %} {% tab title="Maybank" %} ```json { "response": "Transmission of Purchase Detail Info", "trx_id": "9999940800004937", "merchant_id": "99999", "merchant": "Sophia Store", "bill_no": "20201222103549", "bill_items": { "id": "A001", "product": "Invoice #2286704", "qty": "1", "amount": "100000", "payment_plan": "01", "merchant_id": "-", "tenor": "00" }, "response_code": "00", "response_desc": "Success", "https://dev.faspay.co.id/pws/100003/0830000010100000/7ad65e5229511e39159211731978c0777ba0665b?trx_id=9999940800004937&merchant_id=99999&bill_no=20201222103549" } ``` {% endtab %} {% tab title="BRI" %} ```json { "response": "Transmission of Purchase Detail Info", "trx_id": " 99980000000095422", "merchant_id": "99999", "merchant": "Sophia Store", "bill_no": "20201222104021", "bill_items": { "id": "A001", "product": "Invoice #2286704", "qty": "1", "amount": "100000", "payment_plan": "01", "merchant_id": "-", "tenor": "00" }, "response_code": "00", "response_desc": "Success", "redirect_url": "https://dev.faspay.co.id/pws/100003/0830000010100000/972f9dbceffbaf19e5dabcdd3b590532431d905a?trx_id=99980000000095422&merchant_id=99999&bill_no=20201222104021" } ``` {% endtab %} {% tab title="BNI" %} ```json { "response": "Transmission of Purchase Detail Info", "trx_id": "8514999990399725", "merchant_id": "99999", "merchant": "Sophia Store", "bill_no": "20201222104205", "bill_items": { "id": "A001", "product": "Invoice #2286704", "qty": "1", "amount": "100000", "payment_plan": "01", "merchant_id": "-", "tenor": "00" }, "response_code": "00", "response_desc": "Success", "redirect_url": "https://dev.faspay.co.id/pws/100003/0830000010100000/fc6804bcb3d86253145c8a35d727b1a5b3727500?trx_id=8514999990399725&merchant_id=99999&bill_no=20201222104205" } ``` {% endtab %} {% tab title="Sinarmas" %} ```json { "response": "Transmission of Purchase Detail Info", "trx_id": " 8854990000100404", "merchant_id": "99999", "merchant": "Sophia Store", "bill_no": "20201222104353", "bill_items": { "id": "A001", "product": "Invoice #2286704", "qty": "1", "amount": "100000", "payment_plan": "01", "merchant_id": "-", "tenor": "00" }, "response_code": "00", "response_desc": "Success", "redirect_url": "https://dev.faspay.co.id/pws/100003/0830000010100000/131693f2bbb87bca4b73d1df4dfc6e45f626ec96?trx_id=8854990000100404&merchant_id=99999&bill_no=20201222104353" } ``` {% endtab %} {% tab title="Danamon" %} ```json { "response": "Transmission of Purchase Detail Info", "trx_id": "9999970800008557", "merchant_id": "99999", "merchant": "Sophia Store", "bill_no": "20201222104527", "bill_items": { "id": "A001", "product": "Invoice #2286704", "qty": "1", "amount": "100000", "payment_plan": "01", "merchant_id": "-", "tenor": "00" }, "response_code": "00", "response_desc": "Success", "redirect_url": "https://dev.faspay.co.id/pws/100003/0830000010100000/4265a719713828fb1927653fb33b3edde811798d?trx_id=9999970800008557&merchant_id=99999&bill_no=20201222104527" } ``` {% endtab %} {% tab title="CIMB" %} ```json { "response": "Transmission of Purchase Detail Info", "trx_id": "9999982500000216", "merchant_id": "99999", "merchant": "Sophia Store", "bill_no": "20201222104717", "bill_items": { "id": "A001", "product": "Invoice #2286704", "qty": "1", "amount": "100000", "payment_plan": "01", "merchant_id": "-", "tenor": "00" }, "response_code": "00", "response_desc": "Success", "redirect_url": "https://dev.faspay.co.id/pws/100003/0830000010100000/789fb3cbd4dd9e6be750647e71add5cd95288f4a?trx_id=9999982500000216&merchant_id=99999&bill_no=20201222104717" } ``` {% endtab %} {% endtabs %} ### 2. Displaying Virtual Account To display the virtual account number there are two options: * Displaying Virtual Account at merchant's webpage * Redirect to the Faspay page to display Virtual Account, expired time, and how to pay instructions. Read the detailed API reference [here](https://docs.faspay.co.id/merchant-integration/api-reference-1/debit-transaction/redirect-process) or just simply use redirect\_url that is retrieved from Post Data Transaction Response (for JSON Format). {% hint style="info" %} To display the Virtual Account on the merchant's webpage use the trx\_id response from Post Data Transaction as the Virtual Account number Don't forget to display the expiration time and how to pay instructions too. {% endhint %} ### 3. Payment Notification Payment notification from Faspay to the Merchant backend will also be triggered in the event of transaction status getting updated, to ensure the merchant is securely informed. Please provide the URL and make sure it's already registered on Faspay system The detailed API reference can be found [here](https://docs.faspay.co.id/merchant-integration/api-reference-1/debit-transaction/payment-notification)