checkoutToken

نظرة عامة

استدعِ هذا الـ mutation لإنشاء رمز دفع/مفتاح تشفير يوجه إلى صفحة الدفع المستضافة. قدم البيانات الموصوفة بواسطة CreateCheckoutTokenInput (معرف السلة، معلومات الجلسة، روابط النجاح/الإلغاء، إلخ).

• النوع: GraphQL Mutation
• Endpoint: https://appssubdomain.com
• المصادقة: Authorization: Bearer <TOKEN>

Mutation

mutation CreateCheckoutToken($input: CreateCheckoutTokenInput!) {
  createCheckoutToken(input: $input) {
    success
    message
    encryptionKey
    url
  }
}

المتغيرات

عدّل البيانات لتتوافق مع مخطط الـ backend الخاص بك. مثال على الشكل:

{
  "input": {
    "cartId": "<CART_ID>",
    "successUrl": "https://example.com/checkout/success",
    "cancelUrl": "https://example.com/checkout/cancel",
    "currency": "USD"
  }
}

أمثلة

cURL

curl -X POST \
  https://appssubdomain.com\
  -H "Content-Type": "application/json" \
  -H "Authorization: Bearer <TOKEN>" \
  --data-binary @- << 'EOF'
{
  "query": "mutation CreateCheckoutToken($input: CreateCheckoutTokenInput!) { createCheckoutToken(input: $input) { success message url encryptionKey } }",
  "variables": {
    "input": {
      "cartId": "<CART_ID>",
      "successUrl": "https://example.com/checkout/success",
      "cancelUrl": "https://example.com/checkout/cancel"
    }
  }
}
EOF

JavaScript (fetch)

const res = await fetch('https://appssubdomain.com', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    Authorization: 'Bearer ' + token,
  },
  body: JSON.stringify({
    query: `
      mutation CreateCheckoutToken($input: CreateCheckoutTokenInput!) {
        createCheckoutToken(input: $input) {
          success
          message
          url
          encryptionKey
        }
      }
    `,
    variables: {
      input: {
        cartId: '<CART_ID>',
        successUrl: 'https://example.com/checkout/success',
        cancelUrl: 'https://example.com/checkout/cancel',
      },
    },
  }),
});
const json = await res.json();

ملاحظات

• يُعيد الـ mutation قيم success، message، url، و encryptionKey؛ استخدمها للتوجيه إلى صفحة الدفع المستضافة.
• أضف جميع الحقول المطلوبة في CreateCheckoutTokenInput (مرجع السلة، السوق/العملة، روابط إعادة التوجيه، إلخ).
• خزّن أو مرر encryptionKey بشكل آمن؛ قد يكون مطلوباً بواسطة سكريبتات storeGate للتشفير من جانب العميل.