logo
Trustly Docs
BETA

Pending notification

Get updated when customers complete the payment process but before Trustly receives money
Updated 1 month ago

This is a method that Trustly will call on the merchant's system when the end-user has completed the payment process but before the money has been received by Trustly.

Typically the "thank you"-email to the end-user shall be sent when this notification is received and the item reserved in the inventory. Shipment of the item can wait until you receive the Credit notification.

New parameters may be added to the notification in future versions of the API but current parameters will never be removed.

Example of pending notification JSON RPC HTTPS POST data, sent by the Trustly system to the merchants listening service at the specified NotificationURL:

Pending
{
    "method": "pending",
    "params": {
        "signature": "fVhjuMqbsH0Ku ... S16VbzRsw==",
        "uuid": "258a2184-2842-b485-23ca-293425152415",
        "data": {
            "amount": "49.90",
            "currency": "EUR",
            "messageid": "98348932",
            "orderid": "87654567",
            "enduserid": "32123",
            "notificationid": "4876513450",
            "timestamp": "2013-12-20 14:42:04.675645+01"
        }
    },
    "version": "1.1"
}

Valid responses are:

StatusDescription
OKThe notification has been received.


Example

Example of OK response:

Response
{
    "result": {
        "signature": "Jd0hjuf4bsH0Ku ... S16VbzRzz==",
        "uuid": "258a2184-2842-b485-23ca-293425152415",
        "method": "pending",
        "data": {
            "status": "OK"
        }
    },
    "version":"1.1"
}