sverraest/pomelo-php

PHP Bindings for the Pomelo Pay API

PomeloPHP

, _(*1)

PHP API Client and bindings for the Pomelo Pay API, _(*2)

Using this PHP API Client you can interact with your Pomelo Pay: - 💳 Transactions, _(*3)

Installation

Requires PHP 7.0 or higher, _(*4)

The recommended way to install pomelo-php is through Composer:, _(*5)

First, install Composer:, _(*6)

$ curl -sS https://getcomposer.org/installer | php

Next, install the latest pomelo-php:, _(*7)

$ php composer.phar require sverraest/pomelo-php

Finally, you need to require the library in your PHP application:, _(*8)

require "vendor/autoload.php";

Development

• Run composer test and composer phpcs before creating a PR to detect any obvious issues.
• Please create issues for this specific API Binding under the issues section.
• Contact Pomelo Pay directly for Pomelo Pay API support.

Quick Start

PomeloPHP\Client

First get your production or sandbox API key from Pomelo Pay., _(*9)

If you want to get a production client:, _(*10)

use PomeloPHP\Client;

$client = new Client('apikey', 'appid');

If you want to get a sandbox client:, _(*11)

use PomeloPHP\Client;

$client = new Client('apikey', 'appid', 'sandbox');

If you want to pass additional GuzzleHTTP options:, _(*12)

use PomeloPHP\Client;

$options = ['headers' => ['foo' => 'bar']];
$client = new Client('apikey', 'appid', 'sandbox', $options);

Available API Operations

The following exposed API operations from the Pomelo Pay API are available using the API Client., _(*13)

See below for more details about each resource., _(*14)

💳 Transactions, _(*15)

Create a new transaction with or without a specific payment method., _(*16)

Usage details

💳 Transactions

Create transaction with a specific payment method

use PomeloPHP\Client;

$client = new Client('apikey', 'appid');

$json = [
 "provider" => "alipay", // Payment method enabled for your merchant account such as bcmc, alipay, card
 "currency" => "GBP",
 "amount" => 1000, // 10.00 GBP
 "redirectUrl" => "https://foo.bar/order/123" // Optional redirect after payment completion
];

$transaction = $client->transactions->create($json);
header('Location: '. $transaction["url"]); // Go to transaction payment page

Create transaction without a payment method that will redirect to the payment method selection screen

use PomeloPHP\Client;

$client = new Client('apikey', 'appid');

$json = [
 "currency" => "GBP",
 "amount" => 1000, // 10.00 GBP
 "redirectUrl" => "https://foo.bar/order/987" // Optional redirect after payment completion
];

$transaction = $client->transactions->create($json);
header('Location: '. $transaction["url"]); // Go to payment method selection screen

About

➡️ You can follow me on 🐦 Twitter or ✉️ email me at simon[-at-]pomelopay.com., _(*17)

⭐ Sign up as a merchant at https://pomelopay.com and start receiving payments in seconds., _(*18)