IPN

Instant Payment Notification

Every time a transaction is changed to a final status (completed, denied), Vita Business will send an IPN under the POST method with the status change data to the notification url (url_notify) provided by merchant.

Request Body

Field	Description
status	Transaction status
order	Unique order id provided by merchant
wallet	Wallet UUID and token { "token": "token", "uuid": "wallet_uuid" }

Security

Merchant is required to validate IPN info by calculating the signature according to request body and its headers (Authorization, X-Date, X-Login, X-Trans-Key).

IPN signature calculation

hash = {
    status: "pending",
    order: "222222223",
    wallet: {
        token: "KipouKI77",
        uuid: "11158-OPOS74s4-oospop-7785s74u"
    }
}

// result
// order222222223statuspendingwallet{"token":"KipouKI77","uuid":"11158-OPOS74s4-oospop-7785s74u"}

Vita Business will send IPN every 10 minutes, for 30 days, until we get a 200 status code as reponse from merchant servers.