The Smarter Way
Search…
⌃K

Webhook operation

Overview

Ottu will trigger a call to webhook_url to disclose the transactional data on the webhook_url when any transaction operations got triggered capture, refund, void, and cancel
{
"amount":"14.00",
"initiator":{
"email":"[email protected]",
"id":83,
"username":"iitiator"
},
"is_sandbox":false,
"operation":null,
"pg_code":"mpgs-ksa",
"pg_response":{
"It will contain the raw pg response sent by the pg to Ottu."
},
"reference_number":"stageDV37C",
"result":"success",
"source":"input",
"success":true,
"timestamp_utc":"2022-09-07 06:21:46",
"txn":{
"amount":"14.00",
"currency_code":"SAR",
"customer_email":"[email protected]",
"extra":{
"flight-number":"1234",
"full_name":"customer"
},
"order_no":"",
"reference_number":"LEQCJ",
"state":"voided"
}
}

amount string

The merchant should always check if the amount he received from Ottu is the amount of the order, to avoid user changing the cart amount in between

initiator dict

Payment operation creator details, it will be populated only if the operation was triggered from the dashboard or using api with basic auth and not api key
If true, sandbox environment used for this PG settings.

operation string

Choice from "purchase","authorize". Depending on how the PG is being selected.

pg_code string

It is being generated according to user payment gateway code choice from pg_codes list
It will contain the raw payment gateway response sent by the payment gateway to Ottu.
It is unique identifier, assigned by Ottu to any parent payment transaction.

result string

Result of payment operation void, capture or refund

source string

can be input or pg: Input means it was triggered by Ottu side via API or dashboard. PG means it was triggered by bank PG dashboard and Ottu was informed via webhook. Note: Not all PGs are informing ottu when operations are happening on their side, so Ottu might not be aware of all operations on all PGs, only on those which are offering webhook feature.

timestamp_utc format YYYY-MM-DD / HH:MM:SS

Time and date of operation creation.

txn dict

A dictionary will be generated including short summary of the child payment transaction which was created

1
amount string

Requested amount of the payment operation

2
currency_code string

The currency code of the payment operation. More details https://en.wikipedia.org/wiki/ISO_4217 3 letters code

3
customer_email string

Email address of the customer.

4
extra dict

The extra information for the payment details, which the merchant has sent it in key value form. For example:
"flight-number": "1234",
"full_name": "customer

5
order_no string

Merchant unique identifier for the transaction. ABC123_1, ABC123_2, Max length: 128.
It is unique identifier, assigned by Ottu to any child payment transaction , namely the payment attempt .

7
state string