Initiate Payment

Initiates a new payment transaction.

Endpoint: POST create-order

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"
                        
}