Developer
<?php
namespace App\Constants;
use App\Models\UserWallet;
use Illuminate\Support\Str;
class PaymentGatewayConst {
const AUTOMATIC = "AUTOMATIC";
const MANUAL = "MANUAL";
const ADDMONEY = "Add Money";
const MONEYOUT = "Money Out";
const ACTIVE = true;
const TYPEADDSUBTRACTBALANCE = "ADD-SUBTRACT-BALANCE";
const TYPEADDMONEY = "Add Money";
const TYPETRANSFERMONEY = "Transfer Money";
const CARD_PAYMENT = "Payment";
const ENV_SANDBOX = "SANDBOX";
const ENV_PRODUCTION = "PRODUCTION";
const APP = "APP";
const STATUSSUCCESS = 1;
const STATUSPENDING = 2;
const STATUSHOLD = 3;
const STATUSREJECTED = 4;
const STATUSWAITING = 5;
const STATUSTEST = 6;
const PAYPAL = 'paypal';
const G_PAY = 'gpay';
const COIN_GATE = 'coingate';
const QRPAY = 'qrpay';
const TATUM = 'tatum';
const STRIPE = 'stripe';
const FLUTTERWAVE = 'flutterwave';
const SSLCOMMERZ = 'sslcommerz';
const RAZORPAY = 'razorpay';
const PERFECT_MONEY = 'perfect-money';
const PAYSTACK = "paystack";
const SEND = "SEND";
const RECEIVED = "RECEIVED";
const PENDING = "PENDING";
const REJECTED = "REJECTED";
const CREATED = "CREATED";
const SUCCESS = "SUCCESS";
const EXPIRED = "EXPIRED";
const FIAT = "FIAT";
const CRYPTO = "CRYPTO";
const CRYPTO_NATIVE = "CRYPTO_NATIVE";
const PROJECT_CURRENCY_SINGLE = "PROJECT_CURRENCY_SINGLE";
const PROJECT_CURRENCY_MULTIPLE = "PROJECT_CURRENCY_MULTIPLE";
const ASSET_TYPE_WALLET = "WALLET";
const CALLBACK_HANDLE_INTERNAL = "CALLBACK_HANDLE_INTERNAL";
const NOT_USED = "NOT-USED";
const USED = "USED";
const SENT = "SENT";
const REDIRECT_USING_HTML_FORM = "REDIRECT_USING_HTML_FORM";
public static function add_money_slug() {
return Str::slug(self::ADDMONEY);
}
public static function money_out_slug() {
return Str::slug(self::MONEYOUT);
}
public static function register($alias = null) {
$gateway_alias = [
self::PAYPAL => "paypalInit",
self::G_PAY => "gpayInit",
self::COIN_GATE => "coinGateInit",
self::QRPAY => "qrpayInit",
self::TATUM => 'tatumInit',
self::STRIPE => 'stripeInit',
self::FLUTTERWAVE => 'flutterwaveInit',
self::SSLCOMMERZ => 'sslCommerzInit',
self::RAZORPAY => 'razorpayInit',
self::PERFECT_MONEY => 'perfectMoneyInit',
self::PAYSTACK => 'paystackInit'
];
if($alias == null) {
return $gateway_alias;
}
if(array_key_exists($alias,$gateway_alias)) {
return $gateway_alias[$alias];
}
return "init";
}
public static function registerWallet() {
return [
'web' => UserWallet::class,
'api' => UserWallet::class,
];
}
public static function apiAuthenticateGuard() {
return [
'api' => 'web',
];
}
public static function registerRedirection() {
return [
'web' => [
'return_url' => 'user.add.money.payment.success',
'cancel_url' => 'user.add.money.payment.cancel',
'callback_url' => 'user.add.money.payment.callback',
'redirect_form' => 'user.add.money.payment.redirect.form',
'btn_pay' => 'user.add.money.payment.btn.pay',
],
'api' => [
'return_url' => 'api.user.add.money.payment.success',
'cancel_url' => 'api.user.add.money.payment.cancel',
'callback_url' => 'user.add.money.payment.callback',
'redirect_form' => 'user.add.money.payment.redirect.form',
'btn_pay' => 'api.user.add.money.payment.btn.pay',
],
];
}
public static function registerGatewayRecognization() {
return [
'isGpay' => self::G_PAY,
'isPaypal' => self::PAYPAL,
'isCoinGate' => self::COIN_GATE,
'isQrpay' => self::QRPAY,
'isTatum' => self::TATUM,
'isStripe' => self::STRIPE,
'isFlutterwave' => self::FLUTTERWAVE,
'isSslCommerz' => self::SSLCOMMERZ,
'isRazorpay' => self::RAZORPAY,
'isPerfectMoney' => self::PERFECT_MONEY,
'isPaystack' => self::PAYSTACK,
];
}
}
Developer
Initiates a new payment transaction.
| Parameter | Type | Details |
|---|---|---|
| amount | decimal | Your Amount , Must be rounded at 2 precision. |
| currency | string | Currency Code, Must be in Upper Case (Alpha-3 code) |
| success_url | string | Enter your return or success URL |
| cancel_url | string (optional) | Enter your cancel or failed URL |
Request Example (guzzle)
<?php
require_once('vendor/autoload.php');
$client = new \GuzzleHttp\Client();
$response = $client->request('POST', $base_url.'create-order', [
'headers' => [
'Authorization' => 'Bearer '. $authorizationToken,
'accept' => 'application/json',
'content-type' => 'application/json',
],
'form_params' => [
'amount' => '$amount',
'currency' => 'currency',
'success_url' => 'success_url',
'cancel_url' => 'cancel_url',
],
]);
echo $response->getBody();
**Response: SUCCESS (200 OK)**
{
"message": {
"success": [
"Order created successfully."
]
},
"data": {
"redirect_url":"https://example.com/login/OISADFDFSDFSF",
"order_details":{
"amount" : "10",
"fixed_charge" : 2,
"percent_charge" : 1,
"total_charge" : 3,
"total_payable" : 13,
"currency" : "USD",
"expiry_time": "2024-04-25T06:48:35.984285Z",
"success_url": "http://127.0.0.1/nfcpay/user/transaction/success",
"cancel_url": "http://127.0.0.1/nfcpay/user/transaction/cancel"
}
},
"type": "success"
}
**Response: ERROR (400 FAILED)**
{
"message": {
"error": [
"Invalid token."
]
},
"data": null,
"type": "error"
}