iPay88 Indonesia - Mobile SDK

Catatan Penting

1. Mobile SDK berikut adalah standar iPay88 Indonesia.
2. Anda dapat menambahkan kode pada Mobile SDK sesuai dengan kebutuhan bisnis Anda.
3. Lakukan uji transaksi pada fase development atau sandbox terlebih dahulu sebelum memasuki fase production.

Android Mobile Payment SDK

Segera integrasikan iPay88 android mobile payment sdk ini dengan aplikasi android Anda. SDK ini memungkinkan aplikasi android Anda menerima pembayaran online secara langsung melalui iPay88 Indonesia.

Prasyarat Pengembangan Aplikasi dengan iPay88

Silahkan berikan merchant code Anda kepada iPay88 Indonesia untuk memverifikasi identitas merchant. iPay88 perlu mengkonfigurasi merchant code Anda kedalam server untuk memungkinkan aplikasi android Anda menggunakan gerbang pembayaran iPay88 Indonesia.

Library pada iPay88 Android Mobile Payments

Bagian ini menjelaskan library secara detil, yakni iPay88 android mobile payments API dan memberikan petunjuk untuk mengintegrasikan library tersebut dengan aplikasi Android Anda.

Referensi Mobile Payments Library API

1. Aplikasi Anda menginisialisasi library.
2. Setelah pelanggan menyelesaikan pembayaran mereka, library mengembalikan data atau callback ke aplikasi Anda dengan status pembayaran dan ID transaksi.
3. Setelah alur dari library selesai, hasil aktivitas akan dikirimkan ke aplikasi Anda.

Deklarasi Library dan Permission pada AndroidManisfest.xml

Mobile Payments library adalah sebuah aktivitas, oleh karena itu Anda harus mendeklarasikannya dalam file AndroidManifest.xml pada aplikasi Anda. Anda harus deklarasikan mengenai internet and phone state permission yang diperlukan oleh library.

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.android.ipay" android:versionCode="1" android:versionName="1.0" > 

<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.READ_PHONE_STATE"/>
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
<uses-sdk android:minSdkVersion="9" android:targetSdkVersion="18" />

<application android:icon="@drawable/ipay88logo" android:label="@string/app_name" >

<activity android:name="IPAYSampleActivity" android:label="@string/app_name" >
         
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>

</activity>

<activity android:name="com.ipay.IpayAcitivity" android:configChanges="orientation|screenSize"/>
<activity android:name="com.ipay.IpayAcitivityR" android:configChanges="orientation|screenSize"/>
</application>

</manifest>
                        

Menambahkan Jar File Library dan Impor Kelas

1. Klik kanan pada proyek Anda dan pilih "Properties".
2. Pilih "Java Build Path".
3. Pilih tab "Libraries".
4. Pilih tombol "Add Jars…"
5. Pilih file "ipay88_android.jar" dari struktur folder Anda dan klik "OK"

//Anda perlu mengimpor kelas yang sesuai ke dalam kelas aplikasi. Kelas-kelas berikut harus di-impor.

import com.ipay.Ipay;
import com.ipay.IpayPayment;
import com.ipay.IpayR;
                        

Memulai Aktivitas Library

Library ini menggunakan mekanisme native android activity untuk memulai alur pembayaran dan untuk mengkomunikasikan data kembali ke aplikasi Anda. Selain data respon atau onActivityResult callback, Anda dapat mengimplementasikan IpayResultDelegate untuk segera menginformasikan apabila pembayaran berhasil diselesaikan.

Untuk memulai pembayaran dengan Ipay88, Anda harus memulai aktivitas Library menggunakan metode Android startActivityForResult. Lakukan ini ketika pembeli menyentuh tombol bayar. Aplikasi harus mengirim data ke iPay88 agar data dapat diproses sebagai objek Pembayaran. IpayPayment menangani pembayaran sederhana, yang mendukung satu penerima pembayaran dengan satu transaksi dan beberapa rincian.

//Dalam contoh di bawah ini, pembeli membayar dengan pembayaran sederhana untuk satu penerima

IpayPayment payment = new IpayPayment();

payment.setMerchantKey (txtMerchantKey.getText().toString());
payment.setMerchantCode (txtMerchantCode.getText().toString());
payment.setPaymentId (txtPaymentID.getText().toString());
payment.setCurrency (txtCurrency.getText().toString());
payment.setRefNo (txtRefID.getText().toString());
payment.setAmount (txtAmount.getText().toString());
payment.setProdDesc (txtProdDesc.getText().toString());
payment.setUserName (txtUserName.getText().toString());
payment.setUserEmail (txtUserEmail.getText().toString());
payment.setUserContact (txtUserContact.getText().toString());
payment.setRemark (txtRemark.getText().toString());
payment.setLang (txtLang.getText().toString());
payment.setCountry (txtCountry.getText().toString());
payment.setBackendPostURL (txtBackendPost.getText().toString());

Intent checkoutIntent = Ipay.getInstance().checkout(payment, this, new ResultDelegate());
startActivityForResult(checkoutIntent, 1);
                        

Metode Pada Library

Metode yang digunakan adalah getInstance Method. Metode ini mengembalikan objek tunggal Ipay.

Ipay ipay = Ipay.getInstance ();

Antarmuka untuk memberikan rincian tentang kapan pembayaran diselesaikan didefinisikan dalam com.ipay.IpayResultDelegate.

//Dengan antarmuka ini, Anda segera diberitahu ketika pembayaran telah selesai

public abstract interface IpayResultDelegate 
{
   public abstract void onPaymentSucceeded(String TransId, String RefNo, String Amount, String Remark, String AuthCode);
   
   public abstract void onPaymentFailed(String TransId, String RefNo, String Amount, String Remark, String ErrDesc);
   
   public abstract void onPaymentCanceled(String TransId, String RefNo, String Amount, String Remark, String ErrDesc);

   ** (For Requery Result Purpose)
   public abstract void onRequeryResult(String MerchantCode, String RefNo, String Amount, String Result);
}
                        

Fungsi Requery

1. Buat tombol requery pada aplikasi Anda.
2. Tetapkan onclicklistener ke tombol tersebut.
3. Hasil akan ditampilkan pada label yang Anda tentukan di ResultDelegate().

//Ketika tombol diklik oleh pengguna, jalankan kode di bawah ini

String local_MerchantCode = txtMerchantCode.getText().toString();
String local_RefID   = txtRefID.getText().toString();
String local_Amount  = txtAmount.getText().toString();
IpayR r             = new IpayR();

r.setMerchantCode(local_MerchantCode);
r.setRefNo(local_RefID);
r.setAmount(local_Amount);

Intent checkoutIntent = Ipay.getInstance().requery(r,this, new ResultDelegate());

startActivityForResult(checkoutIntent, 1);
                        

Custom Objects Dalam Mobile Payments Library

Library pada Mobile Payments menyertakan objek khusus yang dikirim oleh libarary sebagai jembatan antara aplikasi Anda dengan iPay88 selama proses pembayaran.

IpayPayment
Objek ini diteruskan ke library melalui data ekstra dalam Intent ketika Aktivitas library dimulai. Objek ini berisi semua nilai untuk pembayaran.

Payment Response

Berikut ini adalah respon dengan HTTPS POST dari iPay88 OPSG ke merchant setelah selesai proses pembayaran.

Backend Post Feature

Backend post feature atau BackendPostURL adalah teknologi server ke server yang tidak bergantung pada aplikasi yang terdapat pada perangkat pelanggan merchant. Fitur ini harus diimplementasikan di aplikasi merchant. Tujuan fitur ini adalah untuk mendapatkan status pembayaran dari iPay88 OPSG. Merchant bisa mendapatkan status pembayaran melalui laman backend merchant. iPay88 OPSG dapat mengirim status pembayaran secara berulang walaupun laman respon merchant pada aplikasi gagal mendapatkan status tersebut yang disebabkan oleh aplikasi ditutup, batas waktu koneksi internet, dan lain sebagainya.

Implementasi

Pada server merchant, buat laman lain sebagai backend (BackendPostURL) untuk menerima parameter dari iPay88. Parameter backend yang dikirim oleh iPay88 sama seperti parameter yang dikirim ke laman response merchant. Pada laman request merchant, tentukan url backend melalui parameter "BackendPostURL".

Pada laman BackendPostURL Anda perlu menuliskan kata 'RECEIVEOK' saja (tanpa tanda kutip) sebagai konfirmasi setelah laman backend berhasil mendapatkan status pembayaran dari iPay88 OPSG. Tentunya kata tersebut tertulis setelah dilakukan pengecekan seperti signature dan lain sebagainya di laman backend merchant. iPay88 OPSG akan mencoba mengirim kembali status pembayaran ke laman 'backend_response' hingga 5 kali pada interval yang berbeda jika tidak terdeteksi 'RECEVEIOK'.

Contoh:

Di ASP >> response.write "RECEIVEOK"
Di PHP >> echo "RECEIVEOK";

Catatan:

1. iPay88 OPSG hanya mengirim status pembayaran melalui laman backend merchant apabila status pembayaran pada transaksi merchant telah sukses. Jika status pembayaran gagal, maka iPay88 OPSG tidak akan mengirimkan status melalui laman backend merchant.

2. Pastikan tidak ada kode/tag HTML di laman BackendPostURL merchant.

3. Pastikan BackendPostURL merchant berisi pengkodean/fungsi untuk memperbarui pesanan (update order) selain menggunakan metode onPaymentSucceeded.

4. Laman backend merchant harus menerapkan beberapa pengecekan yang sama seperti laman response seperti pengecekan signature, dan lain sebagainya untuk mencegah tejadinya pembajakan pada sistem merchant.

5. Pastikan untuk melaksanakan pemeriksaan untuk menentukan "onPaymentSucceeded method" atau "BackendPostURL" saat memperbarui pesanan, sehingga sistem pedagang tidak akan memperbarui status lebih dari 1 kali. Catatan: Saat pembayaran berhasil, iPay88 akan mengembalikan status pembayaran sukses ke "SDK" dan "BackendPostURL".

6. Anda perlu melakukakan pemeriksaan untuk menentukan fungsi perubah status transaksi baik di metode "onPaymentSucceeded" atau "BackendPostURL" sehingga tidak terjadinya perubahan status transaksi lebih dari satu kali.

   Note: Setelah iPay88 OPSG menerima informasi dari bank bahwa status pembayaran pada transaksi merchant telah suskes, iPay88 OPSG secara bersamaan akan mengirimkan status pembayaran tersebut ke "SDK" dan "BackendPostURL".

7. Pastikan BackendPostURL pada aplikasi merchant hanya membalas 'RECEIVEOK'.

8. BackendPostURL bukan pengganti metode IpayResultDelegate untuk mendapatkan status sukses pembayaran sehingga merchant masih perlu menerapkan IpayResultDelegate pada aplikasi untuk mendapatkan status pembayaran.

<%

MerchantCode = Request.Form("MerchantCode")
PaymentId    = Request.Form("PaymentId")
RefNo        = Request.Form("RefNo")
Amount       = Request.Form("Amount")
eCurrency    = Request.Form("Currency")
Remark       = Request.Form("Remark")
TransId      = Request.Form("TransId")
AuthCode     = Request.Form("AuthCode")
Status       = Request.Form("Status")
ErrDesc      = Request.Form("ErrDesc")
Signature    = Request.Form("Signature")

%>

<Add your programming code here>

IF Status=1 THEN
COMPARE Return Signature with Generated Response Signature
   
//update order to PAID
response.write "RECEIVEOK"

ELSE
// update order to FAIL
                        

<?php

$merchantcode = $_REQUEST["MerchantCode"];
$paymentid    = $_REQUEST["PaymentId"];
$refno        = $_REQUEST["RefNo"];
$amount       = $_REQUEST["Amount"];
$ecurrency    = $_REQUEST["Currency"];
$remark       = $_REQUEST["Remark"];
$transid      = $_REQUEST["TransId"];
$authcode     = $_REQUEST["AuthCode"];
$status       = $_REQUEST["Status"];
$errdesc      = $_REQUEST["ErrDesc"];
$signature    = $_REQUEST["Signature"];

//add your programming code here

if($status=1) 
{
   COMPARE Return Signature with Generated Response Signature
   
   //update order to PAID
   echo "RECEIVEOK";
}

else 
{
   //update order to FAIL
}
                        

Response dan Backend Signature

Jika status pembayaran dari transaksi merchant dinyatakan sukses, iPay88 OPSG akan mengirim signature di laman response dan backend merchant. Signature ini harus dibandingkan dengan signature yang dihasilkan oleh merchant sendiri guna mengindari adanya pembajakan. Signature tersebut adalah hasil dari pengacakan tujuh bidang utama berikut.

1. MerchantKey (disediakan dan hanya untuk merchant oleh iPay88 OPSG)
2. MerchantCode
3. PaymentId
4. RefNo
5. Amount
6. Currency
7. Status

Field harus tersusun mengikuti aturan berikut:
MerchantKey & MerchantCode & PaymentId & RefNo & Amount & Currency & Status.

Contoh:

Pengacakan akan dihitung melalui string berikut:
applekeyID000011A00000001300000IDR1||IPP:3||

Hasil signature (menggunakan algoritma SHA1) adalah:
LG6ywEKkZxBYnZjHcUcSKGO4gwQ=

Untuk memastikan signature yang dihasilkan sudah benar, silahkan klik tautan ini untuk perbandingan signature.

Function GetHash(ByVal Source)

   on error resume next
  
   QString = "Source=" & Source
   URL     = "https://www.mobile88.com/DotNet/SHA1Hash.aspx"
  
   Dim strReturn, TryNo
  
   strReturn = ""
   TryNo     = 1
   Set xobj  = Server.CreateObject ("MSXML2.ServerXMLHTTP")
   
   xobj.open "POST", URL, false
   xobj.setRequestHeader "Content-Type", "application/x-www-form-urlencoded"
   xobj.send QString
   
   strReturn = xobj.responseText
   Set xobj  = nothing

   If Err.number <> 0 then
      GetHash = ""
      Err.Clear
   
   else
      GetHash = Mid(strReturn,InStr(strReturn,"")+6,InStr(strReturn,"")-7)
  
   End If

End Function
                        

<?php

function iPay88_signature($source)
{
   return base64_encode(hex2bin(sha1($source)));
}

if (!function_exists('hex2bin'))
{
   function hex2bin($hexSource)
   {
      for ($i=0;$i<strlen($hexSource);$i=$i+2)
      {
         $bin .= chr(hexdec(substr($hexSource,$i,2)));
      }
      
      return $bin;
    }
}

?>
                        

Public Shared Function ComputeHash(ByVal Key As String) As String

   Dim objSHA1 As New SHA1CryptoServiceProvider()
   objSHA1.ComputeHash(system.Text.Encoding.UTF8.GetBytes(Key.ToCharArray))
   
   Dim buffer() As Byte    = objSHA1.Hash
   Dim HashValue As String = System.Convert.ToBase64String(buffer)

   Return HashValue
   
End Function
                        

iOS Mobile Payment SDK

Segera integrasikan iPay88 iOS mobile payment sdk ini dengan aplikasi iOS Anda. SDK ini memungkinkan aplikasi iOS Anda menerima pembayaran online secara langsung melalui iPay88 Indonesia.

Download Integration Guide

Download iOS SDK

Prasyarat Pengembangan Aplikasi dengan iPay88

Silahkan berikan merchant code Anda kepada iPay88 Indonesia untuk memverifikasi identitas merchant. iPay88 perlu mengkonfigurasi merchant code Anda kedalam server untuk memungkinkan aplikasi android Anda menggunakan gerbang pembayaran iPay88 Indonesia.

Library pada iPay88 iOS Mobile Payments

Bagian ini menjelaskan library secara detil, yakni iPay88 iOS mobile payments API dan memberikan petunjuk untuk mengintegrasikan library tersebut dengan aplikasi iOS Anda.

Referensi Mobile Payments Library API

1. Aplikasi Anda menginisialisasi library.
2. Anda harus menambahkan UI view yang dikembalikan oleh library sebagai subview.
3. Setelah pelanggan menyelesaikan pembayaran mereka, library mengembalikan data melalui callback ke aplikasi Anda dengan status pembayaran dan id transaksi.

Menambahkan File Library dan Impor Header Files

1. Di XCode, buka target build Anda dan klik tab "Build Phases".
2. Di bawah "Link Binary With Libraries", tambahkan library statis "libipay88sdk.a".
3. Tambahkan file header ("Ipay.h" & "IpayPayment.h") ke dalam aplikasi Anda.

Memulai Library UIView

Library ini menggunakan native UIWebView untuk memulai alur pembayaran dan untuk berkomunikasi. Anda dapat menerapkan PaymentResultDelegate agar dapat menerima status secara langsung setelah pelanggan berhasil menyelesaikan pembayaran. Untuk memulai pembayaran dengan iPay88, Anda harus menginisialisasi objek Ipay terlebih dahulu.

Anda harus menggunakan metode checkout dan kirimkan data tersebut melalui objek IpayPayment. IpayPayment menangani pembayaran sederhana yang mendukung satu penerima pembayaran dan satu transaksi dengan beberapa rincian.

Metode Pada Library

1. Metode Checkout

Metode ini mengembalikan UIView. Antarmuka yang menampilkan rincian seperti kapan pembayaran diselesaikan didefinisikan dalam protokol <PaymentResultDelegate>.

2. Metode Requery

hanya properti refNo, merchantCode, dan amount dari objek IpayPayment yang diperlukan untuk requery (sisanya dapat dibiarkan kosong). Antarmuka untuk memberikan rincian tentang kapan requery selesai didefinisikan dalam protokol <PaymentResultDelegate>.

Custom Objects Dalam Mobile Payments Library

Library pada Mobile Payments menyertakan objek khusus yang dikirim oleh libarary sebagai jembatan antara aplikasi Anda dengan iPay88 selama proses pembayaran.

IpayPayment
Objek ini diteruskan ke library melalui data ekstra dalam Intent ketika Aktivitas library dimulai. Objek ini berisi semua nilai untuk pembayaran.

Catatan:
Pastikan merchant account Anda telah menyatakan opsi pembayaran di iPay88 Indonesia.

Referensi

Kami berusaha memberikan informasi selengkap mungkin untuk Anda. Adanya informasi tersebut menjadikan proses integrasi Anda dengan iPay88 OPSG menjadi mudah dan cepat. Untuk itu, kami meyediakan referensi sebagai informasi tambahan untuk Anda. Berikut ini adalah referensi dari iPay88 OPSG.

Testing Credentials

Uji transaksi dengan metode pembayaran kartu kredit melalui sandbox memerlukan data sampel kartu. Berikut ini adalah testing credentials yang dapat digunakan untuk uji transaksi dengan metode pembayaran kartu kredit.

1. Pengujian Data

2. Pengujian Data Eksespsi

Payment ID

Berikut ini adalah daftar Payment ID iPay88 Indonesia berdasarkan metode pembayaran yang tersedia.

1. Credit Card

2. Online Banking

3. ATM Transfer

4. e-Wallet

5. Others

Mata Uang

Berikut ini adalah mata uang yang diharuskan untuk integrasi dengan iPay88 Indonesia.

Deskripsi Error

Berikut ini adalah daftar pesan dan deskripsi error dari iPay88 Indonesia.