README

Ipaymu API PHP 类库用于进行 Ipaymu 的 API 请求。

安装

安装此库的最佳方式是使用 Composer

composer require steevenz/ipaymu

使用方法

use Steevenz\Ipaymu;

/*
 * --------------------------------------------------------------
 * Inisiasi Class Ipaymu
 * --------------------------------------------------------------
 */
 // Untuk menggunakan API Ipaymu Account saja.
 $ipaymu = new Ipaymu();
 $ipaymu->setApiKey('API_KEY_ANDA');
 
 // Untuk menggunakan API Ipaymu Account dan Webstore.
 $ipaymu = new Ipaymu([
    'apiKey' => 'API_KEY_ANDA',
    
    // Konfigurasi Url diperlukan untuk melakukan transaksi ke ipaymu
    'url' => [
        'return' => 'http://www.domainanda.com/terimakasih.html'
        'notify' => ' http://www.domainanda.com/notify-ipaymu.php'
        'cancel' => 'http://www.domainanda.com/batal.html'
    ]
 ]);
 
/*
 * --------------------------------------------------------------
 * Mendapatkan informasi akun Ipaymu
 * 
 * @return array
 * --------------------------------------------------------------
 */
$account = $ipaymu->getAccount();

/*
 * --------------------------------------------------------------
 * Cek Saldo Akun
 * Untuk mengecek jumlah saldo terakhir Anda.
 *
 * @return int
 * --------------------------------------------------------------
 */
$balance = $ipaymu->checkAccountBalance();

/*
 * --------------------------------------------------------------
 * Cek Status Akun
 * Untuk mengecek status akun iPaymu.
 *
 * @return string
 * --------------------------------------------------------------
 */
$status = $ipaymu->checkAccountStatus();

/*
 * --------------------------------------------------------------
 * Cek Transaksi
 *
 * @param string $trxId Kode Unik Transaksi.
 * @return array|bool Returns FALSE if failed.
 * --------------------------------------------------------------
 */
$transaction = $ipaymu->checkTransaction('IDX-1234567890');

/*
 * --------------------------------------------------------------
 * Melakukan transaksi pembayaran dengan single produk
 *
 * @return array|bool   Returns FALSE if failed or returns array contains
 *                      Ipaymu transaction Url.
 * --------------------------------------------------------------
 */
$ipaymu->addTransaction([
   'id' => 'INV-1234567890',
   'product' => [
       'name' => 'Shoes'
       'price' => 10000,
       'quantity' => 1,
       'description' => 'Amazing Shoes'
   ]
]);

/*
 * --------------------------------------------------------------
 * Melakukan transaksi pembayaran PayPal dengan single produk
 * 
 * @return array|bool   Returns FALSE if failed or returns array contains
 *                      Ipaymu transaction Url.
 * --------------------------------------------------------------
 */
$ipaymu->addTransaction([
   'id' => 'INV-1234567890',
   'product' => [
       'name' => 'Shoes'
       'price' => 10000,
       'price_usd' => 1, // Wajib menyertakan harga dalam kurs USD
       'quantity' => 1,
       'description' => 'Amazing Shoes'
   ]
], 'akunpaypalku@domain.com');

/*
 * --------------------------------------------------------------
 * Melakukan transaksi pembayaran dengan multi produk
 * 
 * @return array|bool   Returns FALSE if failed or returns array contains
 *                      Ipaymu transaction Url.
 * --------------------------------------------------------------
 */
 $ipaymu->addTransaction([
      'id' => 'INV-1234567890',
      'products' => [
          [
              'name' => 'Shoes',
              'price' => 10000,
              'quantity' => 1,
              'description' => 'Amazing Shoes'
          ],
          [
              'name' => 'Bag',
              'price' => 5000,
              'quantity' => 2,
              'description' => 'Amazing Bag'
          ]
      ]
 ]);
 
 /*
  * --------------------------------------------------------------
  * Melakukan transaksi pembayaran PayPal dengan multi produk
  * 
  * @return array|bool   Returns FALSE if failed or returns array contains
  *                      Ipaymu transaction Url.
  * --------------------------------------------------------------
  */
  $ipaymu->addTransaction([
       'id' => 'INV-1234567890',
       'products' => [
           [
               'name' => 'Shoes',
               'price' => 10000,
               'price_usd' => 1, // Wajib menyertakan harga dalam kurs USD
               'quantity' => 1,
               'description' => 'Amazing Shoes'
           ],
           [
               'name' => 'Bag',
               'price' => 5000,
               'price_usd' => 1, // Wajib menyertakan harga dalam kurs USD
               'quantity' => 2,
               'description' => 'Amazing Bag'
           ]
       ]
  ], 'akunpaypalku@domain.com');

/*
 * --------------------------------------------------------------
 * Mendapatkan original response object.
 * --------------------------------------------------------------
 */
 $response = $ipaymu->getResponse();
 
/*
 * --------------------------------------------------------------
 * Mendapatkan informasi error.
 * --------------------------------------------------------------
 */
 $errors = $ipaymu->getErrors();

更详细的信息可以在 Wiki 中找到

想法、批评和建议

如果您有任何想法、批评或建议，您可以发送电子邮件到 steevenz@stevenz.com。您还可以访问我的个人网站 steevenz.com

错误和问题

如果您发现错误或问题，您可以在 Github Issues 中发布。

需求

• PHP 5.6+
• Composer
• O2System Curl

参考

有关 RajaOngkir API 的更多信息，请参阅 Ipaymu API 文档.