Loading

الربط مع منصات التجارة الالكترونية

اسهل طريقة للربط مع المنصات العالمية

لن تحتاج إلى الدخول على صفحة الأكواد السوداء أو التعامل مع الرموز الملغزة أو الأكواد المحيرة. طويق باي توفر عليك الكثير من المعاناة الرقمية في التعامل مع الأكواد والرموز البرمجية. فمن خلال لوحة التحكم الخاصة بطويق باي يمكنك الربط مع أي منصة تجارية عالمية بخاصية السحب والإفلات Drag & Drop خلال دقائق معدودة. لن تحتاج إلى تدريب متخصص. لن تحتاج إلى خبرة برمجية سابقة. لن يستغرق الأمر منك أكثر من دقائق معدودة.

                                          
curl --location --request POST https://tuwaiqpay.com.sa'/api/payment/create' \
--form 'token="MERCHANT_KEY"' \
--form 'public_key="PUBLIC_KEY"' \
--form 'callback_url="yourodmain.com/redirect"' \
--form 'reference_code="ref_1"' \
--form 'amount="10"' \
--form 'email="test@email.com"' \
--form 'first_name="jhone "' \
--form 'last_name="doe"' \
--form 'title="test payment"' \
--form 'description="payment description"' \
--form 'quantity="1"' \
--form 'currency="USD"'
                                       
                                          
$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => https://tuwaiqpay.com.sa'/api/payment/create',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => array(
    'token' => 'MERCHANT_KEY',
    'public_key' => 'PUBLIC_KEY',
    'callback_url' => 'yourodmain.com/redirect',
    'reference_code' => 'ref_1',
    'amount' => '10',
    'email' => 'test@email.com',
    'first_name' => 'jhone ',
    'last_name' => 'doe',
    'title' => 'test payment',
    'description' => 'payment description',
    'quantity' => '1',
    'currency' => 'USD'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;                                          

                                       
                                            
<form method="POST" action="https://tuwaiqpay.com.sa/api/payment/merchant/create" >
        <input type="hidden" name="token" value="MERCHANT_KEY" />
        <input type="hidden" name="public_key" value="PUBLIC_KEY" />
        <input type="hidden" name="callback_url" value="https://yourdomain.com/success" />
        <input type="hidden" name="reference_code" value="UNIQUE_REF_ID" />
        <input type="hidden" name="amount" value="100" />
        <input type="hidden" name="email" value="user@test.com" />
        <input type="hidden" name="first_name" value="John" />
        <input type="hidden" name="last_name" value="Doe" />
        <input type="hidden" name="title" value="Payment For Products" />
        <input type="hidden" name="description" value="The description of entire payments" />
        <input type="hidden" name="quantity" value="1" />
        <input type="hidden" name="currency" value="USD" />
        <input type="submit" value="submit" />
</form>
                                           
                                       

var request = require('request');
var options = {
  'method': 'POST',
  'url': https://tuwaiqpay.com.sa'/api/payment/create',
  'headers': {
  },
  formData: {
    'token': 'MERCHANT_KEY',
    'public_key': 'PUBLIC_KEY',
    'callback_url': 'https://yourdomain.com/success',
    'reference_code': 'ref_1',
    'amount': '10',
    'email': 'test@email.com',
    'first_name': 'jhone ',
    'last_name': 'doe',
    'title': 'test payment',
    'description': 'payment description',
    'quantity': '1',
    'currency': 'USD'
  }
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

require "uri"
require "net/http"

url = URI(https://tuwaiqpay.com.sa"/api/payment/create")

http = Net::HTTP.new(url.host, url.port);
request = Net::HTTP::Post.new(url)
form_data = [['token', 'MERCHANT_KEY'],['public_key', 'PUBLIC_KEY'],['callback_url', 'https://yourdomain.com/success'],['reference_code', 'ref_1'],['amount', '10'],['email', 'test@email.com'],['first_name', 'jhone '],['last_name', 'doe'],['title', 'test payment'],['description', 'payment description'],['quantity', '1'],['currency', 'USD']]
request.set_form form_data, 'multipart/form-data'
response = http.request(request)
puts response.read_body


import requests

url = https://tuwaiqpay.com.sa"/api/payment/create"

payload={'token': 'MERCHANT_KEY',
'public_key': 'PUBLIC_KEY',
'callback_url': 'https://yourdomain.com/success',
'reference_code': 'ref_1',
'amount': '10',
'email': 'test@email.com',
'first_name': 'jhone ',
'last_name': 'doe',
'title': 'test payment',
'description': 'payment description',
'quantity': '1',
'currency': 'USD'}
files=[

]
headers = {}

response = requests.request("POST", url, headers=headers, data=payload, files=files)

print(response.text)


رد اتصال Json ناجح

يمكنك التحقق من العملية بسهولة

يمكنك الاطلاع الي نتيجة العملية والتحقق منها بكل سهول عن طريق الحالة للعملية والرسالة التي تؤكد حالة العملية اذا تم قبولها او رفضها

 
{
    "message": "Order Created Successfully",
    "status": "success",
    "redirect": "https://example.com/merchant/1/0fc073ef-73e9-42f1-9ebe-ca3383d1b37a",
    "data": {
        "user_id": 3,
        "website_id": 1,
        "currency_id": 4,
        "reference_code": "REF_000002",
        "amount": "1000",
        "quantity": "5",
        "meta": {
            "title": "Payment for product purchasing",
            "first_name": "John",
            "last_name": "Deo",
            "description": "The description of entire payments",
            "callback_url": "https://example.com/success",
            "ip_address": "127.0.0.1",
            "user-agent": "PostmanRuntime/7.29.2"
        },
        "uuid": "0fc073ef-73e9-42f1-9ebe-ca3383d1b37a",
        "updated_at": "2022-08-22T05:47:04.000000Z",
        "created_at": "2022-08-22T05:47:04.000000Z",
        "id": 1
    }
}
                                           

رد اتصال Json ناجح

التحقق من عملية الدفع بسهولة

يمكنك الاطلاع الي نتيجة العملية والتحقق منها بكل سهول عن طريق الحالة للعملية والرسالة التي تؤكد حالة العملية اذا تم قبولها او رفضها

 
$ch = curl_init();
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_URL, 'https://tuwaiqpay.com.sa/api/payment/merchant/verify/{REFERENCE_KEY}/{SECRET_KEY}');
$result = curl_exec($ch);
curl_close($ch);
$obj=json_decode($result, true);
//Verify Payment
if (array_key_exists("data", $obj)  && ($obj["status"] == "success")) {
    echo 'success';
}
                                           

المتطلبات

S/N القيمة النوع مطلوب وصف
1. token string نعم تستخدم لتأمين الصفحة
2. callback_url url نعم هذه نقطة نهاية رد الاتصال التي تقدمها
3. reference_code string نعم هذا هو مرجع التاجر المرتبط بالمعاملة
5. amount int [Above 0.50 cents] نعم تكلفة السلعة المشتراة
6. email string نعم البريد الإلكتروني للعميل الذي يقوم بالدفع
7. الأسم الأول string, max:100 نعم الاسم الأول للعميل الذي يقوم بالدفع
8. last_name string, max:100 نعم الاسم الأخير للعميل الذي يقوم بالدفع
9. title string, max:255 نعم عنوان الصفقة
10. description string, max:1000 نعم وصف الغرض من المعاملة
11. currency string نعم هذه هي العملة التي يجب أن تأتي قائمة المعاملات بالريال السعودي
12. quantity int نعم كمية السلعة التي يتم دفع ثمنها

Copyright © 2022. All Rights Reserved TuwaiqPay