SCI GUIDE

Untuk bisa memanfaatkan fasilitas ini merchant harus memiliki akun FasaPay berstatus Store atau Perusahaan.
Detail mengenai persyaratan dan limit untuk Status Store atau Perusahaan, klik di sini.

Catatan:
SCI tidak harus menggunakan Shopping Cart. kalau ingin menggunakan seperti tombol buy now silahkan ubah tombol submit menjadi tombol buy now atau gunakan input type image seperti pada tombol Donate.
silahkan ambil disini untuk implementasi langsung Buy Now, namun jg bisa digunakan untuk Shopping Cart.
Ada dua jenis SCI yang kami sediakan. Yaitu SCI Simple Mode dan Advanced Mode.

SCI Simple Mode SCI Advanced Mode
Digunakan oleh Member : Aktif-Verified Digunakan oleh Merchant : Store/Perusahaan
Tidak bisa memasang logo website Bisa memasang logo website di SCI
Tidak dapat dihubungkan ke database website anda Dapat dihubungkan ke database website anda *)
Pemrosesan transaksi manual (Mengecek transaksi yang masuk dan mengubah sendiri di database website) Pemrosesan transaksi otomatis (Setelah member berhasil membayar, database di website anda berubah secara otomatis)
*harus di-setup oleh tim IT anda terlebih dahulu
*) Menggunakan IPN (Immediate Payment Notification)

Panduan Developer untuk Integrasi SCI

 

REQUEST FORM

Merchant : Penjual
User/Buyer : Pembeli

Form HTML Simple Mode

                <form  method="POST" action="https://sci.fasapay.com/"> 
<input type="hidden" name="fp_acc" value="FP0001">
<input type="hidden" name="fp_item" value="2 buah Baju">
<input type="hidden" name="fp_amnt" value="2000">
<input type="hidden" name="fp_fee_mode" value="FiR">
<input type="hidden" name="fp_currency" value="IDR">
<input type="hidden" name="fp_comments" value="Pembelian 2 buah baju hitam berkerah putih">
<input type="hidden" name="fp_merchant_ref" value="BL002883" />
<input type="hidden" name="fp_fail_url" value="http://www.domain.com/merchant/cancel.php" />
<input type="hidden" name="fp_fail_method" value="GET" />
<!-- additional fields -->
<input type="hidden" name="track_id" value="558421222">
<input type="hidden" name="order_id" value="BJ2993800-">
<input name="" type="submit">
</form>


REQUEST FORM
Merchant : Penjual
User/Buyer : Pembeli

Variable/Input

Keterangan

Keterangan Tambahan

Contoh

fp_acc

Account FasaPay Merchant.
Jika di definiskan maka tidak dapat di ganti

Optional

FP0003

fp_acc_from

Account FasaPay User/Buyer.
Jika di definisikan maka user/buyer di paksa untuk login dengan fp_acc_from

Optional

FP0004

fp_store

Nama Merchant store, akan muncul sebagai Header di halaman transaksi.

Jika Merchant sudah membuat store di accountnya maka dia dapat memanfaatkan advance mode.

Optional

Toko Saya

fp_item

Nama barang dan Jumlah barang yg di beli.
Akan muncul di bagian kiri transaction summary.

Optional

2 Buah Baju

fp_amnt

Amount/Jumlah transaksi yg harus di bayarkan oleh user.

Jika di definiskan maka tidak akan bisa di ubah.
Kosongkan untuk membiarkan user bebas mengirimkan berapapun jumlahnya.

Optional

Float Number

Gunakan ‘titik’ untuk memisahkan desimal

5000

12.5

fp_fee_mode

Tipe Fee yang ingin digunakan. dalam transaksi.

  • FiR = Fee On Recepient
    Fee akan dibebankan ke penerima (merchant)
  • FiS = Fee On Sender
    Fee akan dibebankan ke pengirim (buyer)
  • FsC = Fee On Sender Choice (Default)
    Buyer bebas memilih tipe fee saat pembayaran

Jika tidak di definisikan maka akan menggunakan FsC sehingga pengirim bebas memilih siapa yang akan terkena pembebanan fee.

Isi variable ini dapat otomatis di isikan jika merchant mengaktifkan advance mode

Optional

String

FiR, FiS, FsC

FiR

fp_currency

Kurensi yg di gunakan untuk pembayaran

Jika di definisikan maka tidak dapat di ganti.

Pastikan Account merchant sudah mengaktifkan Kurensi yg di inginkan

Optional

IDR, USD

IDR

fp_comments

Komentar/Catatan Merchant. Tidak dapat di ubah oleh user, namun bisa di tambahi oleh user

Optional
Max : 100

Pembelian 2 Buah Baju Hitam berkerah Putih

fp_merchant_ref

REFERENCE merchant. Bisa digunakan untuk mencocokan/mengidentifikasi transaksi dari user ke Shoping chart merchant.

Optional
Max: 100

MRC5558689-11230

fp_success_url

URL yg di gunakan pada tombol “Return to Merchant” untuk mengirimkan success form pada halaman RESULT.

Isi variable ini dapat otomatis di isikan jika merchant mengaktifkan advance mode

Jika di kosongi maka tidak ada tombol Return to Merchant

Gunakan https jika menggunakan ssl.

Optional

Must be valid URL

http://www.merchant.com/success.html

https://www.merchant.com/success.html

fp_success_method

Method yg di gunakan untuk mengirimkan success form ke fp_success_url pada halaman RESULT.

Isi variable ini dapat otomatis di isikan jika merchant mengaktifkan advance mode

Jika di kosongi maka akan di isi dengan POST

Optional

POST, GET

POST

fp_fail_url

URL yg di gunakan pada tombol “Return to Merchant” untuk mengirimkan fail form pada halaman LOGIN, TRANSFER, CONFIRM untuk membatalkan transaksi.

Isi variable ini dapat otomatis di isikan jika merchant mengaktifkan advance mode

Jika di kosongi maka tidak ada tombol Return to Merchant

Gunakan https jika menggunakan ssl.

Optional

Must be valid URL

http://www.merchant.com/fail.html

https://www.merchant.com/fail.html

fp_fail_method

Method yg di gunakan untuk mengirimkan fail form ke fp_fail_url pada halaman LOGIN, TRANSFER, CONFIRM untuk membatalkan transaksi.

Isi variable ini dapat otomatis di isikan jika merchant mengaktifkan advance mode

Jika di kosongi maka akan di isi dengan POST

Optional

POST, GET

POST

fp_status_url

URL yg digunakan untuk mengirimkan status Form

Isi variable ini dapat otomatis di isikan jika merchant mengaktifkan advance mode

Jika di kosongi maka tidak ada status form yg di kirim ke merchant

Gunakan https jika menggunakan ssl.

Optional

Must be valid URL

http://www.merchant.com/status.html

https://www.merchant.com/status.html

fp_status_method

Method yg digunakan untuk mengirimkan status Form.

Isi variable ini dapat otomatis di isikan jika merchant mengaktifkan advance mode

Jika di kosongi maka akan di isi dengan POST

Optional

Sementara ini hanya mendukung POST

POST

Additional Field

Merchant dapat menambahkan field mereka sendiri.
Field-field ini akan di biarkan oleh SCI namun akan di include kan pada status form, success form, dan fail form

OPTIONAL
Max : 50 field, 100 karakter/field

CKCK222
BJ000333


FAIL FORM

Variable/Input

Keterangan

Keterangan Tambahan

Contoh

fp_paidto

Account FasaPay tujuan. Biasanya Account Merchant

Jika di request form fp_acc di definisikan maka fp_paidto akan sama dengan fp_acc

string

FP0022

fp_amnt

Jumlah yg harus di bayarkan.

Jika fp_amnt di request form tidak di definiskan maka isi fp_amnt fail form juga akan kosong

float

5000

fp_currency

Kurensi yg di gunakan dalam transaksi

Jika fp_currency di request form tidak di definiskan maka isi fp_currency fail form juga akan kosong

String

IDR

fp_store

Nama Store yg di gunakan dalam transaksi

Jika fp_store di request form tidak di definiskan maka isi fp_store fail form juga akan kosong

String

Toko saya

fp_merchant_ref

Berisikan data yg sama dengan fp_merchant_ref di request form

Jika fp_ merchant_ref di request form tidak di definiskan maka isi fp_ merchant_ref fail form juga akan kosong

String

BJ202005

additional field

Addional Field yg ada di Request form akan di includekan dalam form ini juga

 

564654

 

 

 

 

 


SUCCESS FORM

Form ini hanya dibuat jika Transaksi selesai dilakukan.
Form ini baru akan dikirimkan ke SUCCESS_URL jika pembayar mengirimkannya melalui tombol "Kembali ke Merchant".

Mohon hindari menggunakan form ini sebagai validator selesai nya transaksi karena sebelum dikirim ke SUCCESS_URL form ini terlebih dahulu dicetak di browser pengguna, sehingga rentan percobaan tampering atau pengubahan isi data.
jika membutuhkan automatisasi atau validator selesai nya transaksi sebaiknya gunakan STATUS_URL dan STATUS_FORM.

Variable/Input Keterangan Keterangan Tambahan Contoh
fp_paidto Account FasaPay tujuan. Biasanya Account MerchantJika di request form fp_acc di definisikan maka fp_paidto akan sama dengan fp_acc string FP0022
fp_paidby Account FasaPay user yg telah melakukan transaksi/transfer ke account merchant string FP0023
fp_amnt Jumlah yg harus di bayarkan.Jika fp_amnt di request form tidak di definiskan maka isi fp_amnt fail form juga akan kosong float 5000
fp_fee_amnt Jumlah fee FasaPay Float 100
fp_fee_mode Mode fee yang digunakan String FiR, FiS
fp_total Jumlah total yang masuk rekening anda. float 4900
fp_currency Kurensi yg di gunakan dalam transaksiJika fp_currency di request form tidak di definiskan maka isi fp_currency fail form juga akan kosong String IDR
fp_batchnumber Unique batchnumber FasaPay Sring TR2010125596
fp_store Nama Store yg di gunakan dalam transaksiJika fp_store di request form tidak di definiskan maka isi fp_store fail form juga akan kosong String Toko saya
fp_timestamp Waktu transaksi berlangsung Date time 2010/11/10 12:22:55
fp_merchant_ref Berisikan data yg sama dengan fp_merchant_ref di request formJika fp_ merchant_ref di request form tidak di definiskan maka isi fp_ merchant_ref fail form juga akan kosong String BJ202005
additional field Addional Field yg ada di Request form akan di includekan dalam form ini juga   564654
       

 


 

Advance mode akan otomatis digunakan jika request form merchant mengandung fp_store dan fp_acc yg sama dengan yg di-setting di akun FasaPay anda.
Untuk mengaktifkan advance mode maka merchant harus membuat Store dulu.
Store bisa anda temukan halaman member di menu SCI > Store.

Anda bisa menggunakan dummy account untuk testing SCI. Panduan penggunaan dummy account, klik di sini.

REQUEST FORM

Merchant : Penjual
User/Buyer : Pembeli

Form HTML Advance Mode

<form  method="POST" action="https://sci.fasapay.com/"> 
<input type="hidden" name="fp_acc" value="FP0001">
<input type="hidden" name="fp_store" value="tokosaya">
<input type="hidden" name="fp_item" value="2 buah Baju">
<input type="hidden" name="fp_amnt" value="2000">
<input type="hidden" name="fp_currency" value="IDR">
<input type="hidden" name="fp_comments" value="Pembelian 2 buah baju hitam berkerah putih">
<input type="hidden" name="fp_merchant_ref" value="BL002883" />
<input type="hidden" name="fp_success_url" value="http://www.domain.com/merchant/hasil.php" />
<input type="hidden" name="fp_success_method" value="POST" />
<!-- additional fields -->
<input type="hidden" name="track_id" value="558421222">
<input type="hidden" name="order_id" value="BJ2993800-">
<input name="" type="submit">
</form>


REQUEST FORM
Merchant : Penjual
User/Buyer : Pembeli

Variable/Input

Keterangan

Keterangan Tambahan

Contoh

fp_acc

Account FasaPay Merchant.
Jika di definiskan maka tidak dapat di ganti

Optional

FP0003

fp_acc_from

Account FasaPay User/Buyer.
Jika di definisikan maka user/buyer di paksa untuk login dengan fp_acc_from

Optional

FP0004

fp_store

Nama Merchant store, akan muncul sebagai Header di halaman transaksi.

Jika Merchant sudah membuat store di accountnya maka dia dapat memanfaatkan advance mode.

Optional

Toko Saya

fp_item

Nama barang dan Jumlah barang yg di beli.
Akan muncul di bagian kiri transaction summary.

Optional

2 Buah Baju

fp_amnt

Amount/Jumlah transaksi yg harus di bayarkan oleh user.

Jika di definiskan maka tidak akan bisa di ubah.
Kosongkan untuk membiarkan user bebas mengirimkan berapapun jumlahnya.

Optional

Float Number

Gunakan ‘titik’ untuk memisahkan desimal

5000

12.5

fp_fee_mode

Tipe Fee yang ingin digunakan. dalam transaksi.

  • FiR = Fee On Recepient
    Fee akan dibebankan ke penerima (merchant)
  • FiS = Fee On Sender
    Fee akan dibebankan ke pengirim (buyer)
  • FsC = Fee On Sender Choice (Default)
    Buyer bebas memilih tipe fee saat pembayaran

Jika tidak di definisikan maka akan menggunakan FsC sehingga pengirim bebas memilih siapa yang akan terkena pembebanan fee.

Isi variable ini dapat otomatis di isikan jika merchant mengaktifkan advance mode

Optional

String

FiR, FiS, FsC

FiR

fp_currency

Kurensi yg di gunakan untuk pembayaran

Jika di definisikan maka tidak dapat di ganti.

Pastikan Account merchant sudah mengaktifkan Kurensi yg di inginkan

Optional

IDR, USD

IDR

fp_comments

Komentar/Catatan Merchant. Tidak dapat di ubah oleh user, namun bisa di tambahi oleh user

Optional
Max : 100

Pembelian 2 Buah Baju Hitam berkerah Putih

fp_merchant_ref

REFERENCE merchant. Bisa digunakan untuk mencocokan/mengidentifikasi transaksi dari user ke Shoping chart merchant.

Optional
Max: 100

MRC5558689-11230

fp_success_url

URL yg di gunakan pada tombol “Return to Merchant” untuk mengirimkan success form pada halaman RESULT.

Isi variable ini dapat otomatis di isikan jika merchant mengaktifkan advance mode

Jika di kosongi maka tidak ada tombol Return to Merchant

Gunakan https jika menggunakan ssl.

Optional

Must be valid URL

http://www.merchant.com/success.html

https://www.merchant.com/success.html

fp_success_method

Method yg di gunakan untuk mengirimkan success form ke fp_success_url pada halaman RESULT.

Isi variable ini dapat otomatis di isikan jika merchant mengaktifkan advance mode

Jika di kosongi maka akan di isi dengan POST

Optional

POST, GET

POST

fp_fail_url

URL yg di gunakan pada tombol “Return to Merchant” untuk mengirimkan fail form pada halaman LOGIN, TRANSFER, CONFIRM untuk membatalkan transaksi.

Isi variable ini dapat otomatis di isikan jika merchant mengaktifkan advance mode

Jika di kosongi maka tidak ada tombol Return to Merchant

Gunakan https jika menggunakan ssl.

Optional

Must be valid URL

http://www.merchant.com/fail.html

https://www.merchant.com/fail.html

fp_fail_method

Method yg di gunakan untuk mengirimkan fail form ke fp_fail_url pada halaman LOGIN, TRANSFER, CONFIRM untuk membatalkan transaksi.

Isi variable ini dapat otomatis di isikan jika merchant mengaktifkan advance mode

Jika di kosongi maka akan di isi dengan POST

Optional

POST, GET

POST

fp_status_url

URL yg digunakan untuk mengirimkan status Form

Isi variable ini dapat otomatis di isikan jika merchant mengaktifkan advance mode

Jika di kosongi maka tidak ada status form yg di kirim ke merchant

Gunakan https jika menggunakan ssl.

Optional

Must be valid URL

http://www.merchant.com/status.html

https://www.merchant.com/status.html

fp_status_method

Method yg digunakan untuk mengirimkan status Form.

Isi variable ini dapat otomatis di isikan jika merchant mengaktifkan advance mode

Jika di kosongi maka akan di isi dengan POST

Optional

Sementara ini hanya mendukung POST

POST

Additional Field

Merchant dapat menambahkan field mereka sendiri.
Field-field ini akan di biarkan oleh SCI namun akan di include kan pada status form, success form, dan fail form

OPTIONAL
Max : 50 field, 100 karakter/field

CKCK222
BJ000333



FAIL FORM

Variable/Input

Keterangan

Keterangan Tambahan

Contoh

fp_paidto

Account FasaPay tujuan. Biasanya Account Merchant

Jika di request form fp_acc di definisikan maka fp_paidto akan sama dengan fp_acc

string

FP0022

fp_amnt

Jumlah yg harus di bayarkan.

Jika fp_amnt di request form tidak di definiskan maka isi fp_amnt fail form juga akan kosong

float

5000

fp_currency

Kurensi yg di gunakan dalam transaksi

Jika fp_currency di request form tidak di definiskan maka isi fp_currency fail form juga akan kosong

String

IDR

fp_store

Nama Store yg di gunakan dalam transaksi

Jika fp_store di request form tidak di definiskan maka isi fp_store fail form juga akan kosong

String

Toko saya

fp_merchant_ref

Berisikan data yg sama dengan fp_merchant_ref di request form

Jika fp_ merchant_ref di request form tidak di definiskan maka isi fp_ merchant_ref fail form juga akan kosong

String

BJ202005

additional field

Addional Field yg ada di Request form akan di includekan dalam form ini juga

 

564654

 

 

 

 

 


SUCCESS FORM

Form ini hanya dibuat jika Transaksi selesai dilakukan.
Form ini baru akan dikirimkan ke SUCCESS_URL jika pembayar mengirimkannya melalui tombol "Kembali ke Merchant".

Mohon hindari menggunakan form ini sebagai validator selesai nya transaksi karena sebelum dikirim ke SUCCESS_URL form ini terlebih dahulu dicetak di browser pengguna, sehingga rentan percobaan tampering atau pengubahan isi data.
jika membutuhkan automatisasi atau validator selesai nya transaksi sebaiknya gunakan STATUS_URL dan STATUS_FORM.

Variable/Input Keterangan Keterangan Tambahan Contoh
fp_paidto Account FasaPay tujuan. Biasanya Account MerchantJika di request form fp_acc di definisikan maka fp_paidto akan sama dengan fp_acc string FP0022
fp_paidby Account FasaPay user yg telah melakukan transaksi/transfer ke account merchant string FP0023
fp_amnt Jumlah yg harus di bayarkan.Jika fp_amnt di request form tidak di definiskan maka isi fp_amnt fail form juga akan kosong float 5000
fp_fee_amnt Jumlah fee FasaPay Float 100
fp_fee_mode Mode fee yang digunakan String FiR, FiS
fp_total Jumlah total yang masuk rekening anda. float 4900
fp_currency Kurensi yg di gunakan dalam transaksiJika fp_currency di request form tidak di definiskan maka isi fp_currency fail form juga akan kosong String IDR
fp_batchnumber Unique batchnumber FasaPay Sring TR2010125596
fp_store Nama Store yg di gunakan dalam transaksiJika fp_store di request form tidak di definiskan maka isi fp_store fail form juga akan kosong String Toko saya
fp_timestamp Waktu transaksi berlangsung Date time 2010/11/10 12:22:55
fp_merchant_ref Berisikan data yg sama dengan fp_merchant_ref di request formJika fp_ merchant_ref di request form tidak di definiskan maka isi fp_ merchant_ref fail form juga akan kosong String BJ202005
additional field Addional Field yg ada di Request form akan di includekan dalam form ini juga   564654
       

 


STATUS FORM

Form ini hanya dikirimkan jika Transaksi berhasil dilakukan.
Selalu validasi data dari form ini dengan fp_hash atau fp_hash_2,
kemudian bandingkan dengan data yang seharusnya anda terima untuk memvalidasi transaksi.
Variable/Input

Keterangan

Keterangan Tambahan

Contoh

fp_paidto

Account FasaPay tujuan. Biasanya Account Merchant

Jika di request form fp_acc di definisikan maka fp_paidto akan sama dengan fp_acc

string

FP0022

fp_paidby

Account FasaPay user yg telah melakukan transaksi/transfer ke account merchant

string

FP0023

fp_amnt

Jumlah yg di bayarkan.

Jika fp_amnt di request form tidak di definiskan maka isi fp_amnt fail form juga akan kosong

float

5000

fp_fee_amnt

Jumlah fee FasaPay

Float

100

fp_fee_mode

Mode Fee Yang digunakan

String

FiR, FiS

fp_total

Total Dana yang diterima, setelah di Potong Fee

Float

4900, 5000

fp_currency

Kurensi yg di gunakan dalam transaksi

Jika fp_currency di request form tidak di definiskan maka isi fp_currency fail form juga akan kosong

String

IDR

fp_batchnumber

Unique batchnumber FasaPay

Sring

TR2010125596

fp_store

Nama Store yg di gunakan dalam transaksi

Jika fp_store di request form tidak di definiskan maka isi fp_store fail form juga akan kosong

String

Toko saya

fp_timestamp

Waktu transaksi berlangsung

Date time

2010/11/10 12:22:55

fp_merchant_ref

Berisikan data yg sama dengan fp_merchant_ref di request form

Jika fp_ merchant_ref di request form tidak di definiskan maka isi fp_ merchant_ref fail form juga akan kosong

String

BJ202005

fp_hash

Berisikan Hash string menggunakan algoritma sha256 .  Untuk verifikasi data. Untuk cara validasinya silahkan lihat di sini

Akan kosong jika tidak mengaktifkan advance mode

String

8eb7c0e4854aa51c617408a2cfd385b1712e5c9dcd7941ffde31dff052487acc

fp_hash_2

Berisikan Hash string menggunakan algoritma sha256 .  Untuk verifikasi data. untuk cara validasinya silahkan lihat di sini

Akan kosong jika tidak mengaktifkan advance mode

String

36b72939f557ba56c2516e6970692bc2b011b3c69ad40d218fc487955a32eed1

additional field

Addional Field yg ada di Request form akan di includekan dalam form ini juga

 

564654

 

 

 

 

 

HASH GUIDE

fp_hash dan fp_hash_2 adalah fasilitas untuk memvalidasi keaslian data pada status_form.
fp_hash_2 adalah versi baru dari fp_hash yang menambahkan fp_fee_amnt, fp_fee_mode dan fp_total dalam process validasi nya.
berikut adalah contoh pembuatan fp_hash dan fp_hash_2.

Contoh membuat fp_hash

fp_paidto = FP00001
fp_paidby = FP00002
fp_store = toko saya
fp_amnt = 5000
fp_batchnumber = TR201010115555
fp_currency = IDR
Merchant Security Word = Mysecurityword

String yang di hash menjadi

FP00001:FP00002:toko saya:5000:TR201010115555:IDR:Mysecurityword

Di hash menggunakan algoritma sha256 menjadi

8eb7c0e4854aa51c617408a2cfd385b1712e5c9dcd7941ffde31dff052487acc

Contoh membuat fp_hash_2

fp_paidto = FP00001
fp_paidby = FP00002
fp_store = toko saya
fp_amnt = 5000
fp_fee_amnt = 100
fp_fee_mode = FiR
fp_total = 4900
fp_batchnumber = TR201010115555
fp_currency = IDR
Merchant Security Word = Mysecurityword

String yang di hash menjadi

FP00001:FP00002:toko saya:5000:100:FiR:4900:TR201010115555:IDR:Mysecurityword

Di hash menggunakan algoritma sha256 menjadi

a963a290bfb1bb7d0894b7a3ee5e56b79ebea15a468e62b26bf7111c68cfe233