Негізгі мазмұнға өту

Узел api

Бұл узел әртүрлі API-мен өзара әрекеттесуге мүмкіндік береді, бұл сыртқы қызметтермен интеграция үшін пайдалы.

Настройки узла API​

IMG2

1. Name​

Узелдің атын көрсету үшін өріс.
Аты жұмыс аймағында көрсетіледі және узелді оңай анықтауға көмектеседі.
Егер бос қалдырылса, узел API деп аталады.

Мысал:

  • Узелдің аты: Create Payment Session

2. Method​

Мұнда сұраныс жіберу үшін пайдаланылатын API әдісі таңдалады. Қол жетімді әдістер:

  • "Create Payment Session" (Төлем сессиясын жасау):
    Жаңа төлем сессиясын жасайды.

  • "Update Payment Session" (Төлем сессиясын жаңарту):
    Бар төлем сессиясын жаңартады.

  • "Get Payment Session by ID" (ID бойынша төлем сессиясын алу):
    Төлем сессиясының уникалды идентификаторы бойынша ақпарат алады.

  • "Get Payment Session by Order ID" (Order ID бойынша төлем сессиясын алу):
    Тапсырыс идентификаторын пайдаланып, төлем сессиясы туралы ақпарат алады.

Мысал:

  • Әдіс: Create Payment Session

3. Data​

Бұл өріс JSON форматында сұраныс деректерін қалыптастыру үшін Mustache шаблонын пайдаланады.
Шаблонға мәндерді енгізу үшін msg хабарламасынан деректерді пайдалануға болады.

Шаблон мысалы ( "Create Payment Session" әдісі үшін):

 {
   "orderId": {{orderId}},
   "type": "session"
 }

Бұл мысалда orderId мәні msg хабарламасынан енгізіледі.

Шаблон мысалы ( "Update Payment Session" әдісі үшін):

 {
   "id": {{paymentSessionId}},
   "paymentUrl": "{{{payload.links.1.href}}}"
 }

Mustache шаблондары пайдаланылғанда, API-мен өзара әрекеттесу үшін қажетті күрделі деректер мен параметрлерді беруге болады.

Примеры запросов​

Пример 1: Төлем сессиясын жасау​

Настройки узла:

  • Method (Әдіс): Create Payment Session
  • Data (Деректер): 
    {
      "orderId": {{orderId}},
      "type": "session"
    }

Хабарлама:

{
  "orderId": 123
}

Нәтиже:
Узел төлем сессиясын жасау үшін хабарламадағы деректермен сұраныс жібереді. Нәтижесінде жаңа төлем сессиясы туралы ақпарат алынады.

Пример 2: Төлем сессиясын жаңарту​

Настройки узла:

  • Method (Әдіс): Update Payment Session
  • Data (Деректер): 
    {
      "id": {{paymentSessionId}},
      "paymentUrl": "{{{payload.links.1.href}}}"
    }

Хабарлама:

{
  "paymentSessionId": 123,
  "payload": {
    "id": "8YP51523N05861826",
    ....
    "links": [
      {
        "href": "https://api.sandbox.paypal.com/v2/checkout/orders/8YP51523N05861826",
        "rel": "self",
        "method": "GET"
      },
      {
        "href": "https://www.sandbox.paypal.com/checkoutnow?token=8YP51523N05861826",
        "rel": "payer-action",
        "method": "GET"
      }
    ]
  }
}

Нәтиже:
Узел берілген payment_session_id және status мәндерін пайдаланып, төлем сессиясының статусын жаңарту үшін сұраныс жібереді.

Пример 3: ID бойынша төлем сессиясын алу​

Настройки узла:

  • Method (Әдіс): Get Payment Session by ID
  • Data (Деректер): 
    {
      "id": "{{paymentSessionId}}"
    }

Хабарлама:

{
  "paymentSessionId": 123
}

Нәтиже:
Узел төлем сессиясының уникалды идентификаторы бойынша ақпарат алу үшін сұраныс жібереді.

Пример 4: Order ID бойынша төлем сессиясын алу​

Настройки узла:

  • Method (Әдіс): Get Payment Session by Order ID
  • Data (Деректер): 
    {
      "orderId": "{{payload.id}}"
    }

Хабарлама:

{
  "payload": {
    "id": 1
  }
}

Нәтиже:
Узел көрсетілген тапсырыс идентификаторы бойынша төлем сессиясы туралы ақпарат алу үшін сұраныс жібереді.