Skip to main content

action_required

action_required​

Smart Glocal sends you this webhook when you or your users need to carry out certain actions to proceed with the operation. For example, the user might need to go through 3D Secure authentication when paying via a bank card.

The maximum waiting time for an action is 60 minutes. If the action does not occur within this time, the operation will automatically be terminated with the canceled status.

Parameters​

NameMandatoryTypeDescription
type+stringWebhook type: action_required
session+objectPayment session

Example​

curl -X POST \
  https://partner.com \
  -H 'content-type: application/json' \
  -H 'X-PARTNER-SIGN: signature' \
  -d '{
    "type": "action_required",
    "session": {
      "id": "ps_3230",
      "status": "in_progress",
      "created_at": "2024-05-27T02:03:00.000000Z",
      "updated_at": "2024-05-27T02:03:00.000000Z",
      "acquiring_payments": [{
        "id": "pm_1313",
        "status": "pending",
        "created_at": "2024-05-27T02:03:00.000000Z",
        "customer": {
          "reference":"user@sg.com"
        },
        "payment_details": {
          "type": "card",
          "card": {
            "brand": "visa",
            "last4": "8801",
            "bin":"444600"
          }
        },
        "amount_details": {
          "amount": 15000,
          "currency": "usd"
        },
        "transaction_info": {
          "rrn": "425307614918",
          "auth_code": "057441"
        },
        "customer_interaction": {
          "type": "redirect",
          "redirect": {
            "url": "https://website.com?foo=bar",
            "base_url": "https://website.com",
            "method": "POST",
            "qs": {
              "foo": "bar"
            },
            "params": {
              "PaReq": "sdfew^//asdhbv",
              "MD": "abc75daefnn"
            }
          }
        }
      }]
    }
  }'