Skip to main content
POST
/
payment
/
create
Initiate Payment
curl --request POST \
  --url https://quickei.io/pay/sandbox/api/v1/payment/create \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": 123,
  "currency": "<string>",
  "return_url": "<string>",
  "cancel_url": "<string>",
  "product_name": "<string>",
  "order_number": "<string>",
  "custom": "<string>"
}
'
Initiates a new payment transaction.

Endpoint

POST https://quickei.io/pay/sandbox/api/v1/payment/create

Parameters

amount
decimal
required
Amount to charge, rounded to 2 decimal places
currency
string
required
Currency code in uppercase (ISO 4217 Alpha-3)
return_url
string
required
Your return/success URL
cancel_url
string
Your cancel/failure URL
product_name
string
required
Product name or short description
order_number
string
required
Your internal order reference
custom
string
Custom transaction ID for your records

Request Example — Guzzle (PHP)

<?php
require_once('vendor/autoload.php');
$client = new \GuzzleHttp\Client();
$response = $client->request('POST',
  'https://quickei.io/pay/sandbox/api/v1/payment/create', [
  'json' => [
    'amount'       => '100.00',
    'currency'     => 'USD',
    'return_url'   => 'https://yoursite.com/success',
    'cancel_url'   => 'https://yoursite.com/cancel',
    'product_name' => 'MacBook Air',
    'order_number' => 'ORD-2024-001234',
    'custom'       => '123456789ABCD',
  ],
  'headers' => [
    'Authorization' => 'Bearer {{access_token}}',
    'accept'        => 'application/json',
    'content-type'  => 'application/json',
  ],
]);
echo $response->getBody();

Response — 200 OK

{
  "message": {
    "code": 200,
    "success": ["CREATED"]
  },
  "data": {
    "token": "2zMRmT3KeYT2BWMAyGhq...",
    "payment_url": "https://quickei.io/pay/..."
  },
  "type": "success"
}

Error Response — 403 FAILED

{
  "message": {
    "code": 403,
    "error": ["Requested with invalid token!"]
  },
  "data": [],
  "type": "error"
}