logo
Trustly Docs
BETA

Account notification

Get information about a customer's account used in an order
Updated 1 day ago

Overview

This is a method that Trustly will call on the merchant's system in order to send information about the account used in this order.

This notification is not enabled by default, please contact our support if you want to receive it.

KYC data in account notification

For additional personal data in account notification, merchant will need to use Trustly's Lean KYC service.

Restrictions in provided data may apply depending on merchant business and/or markets. For more information, reach out to your commercial contact at Trustly.

Parameters

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

Example

Example of an account notification, sent by the Trustly system to the merchants listening service at the specified NotificationURL:

Account
Account, with KYC data
{
    "method": "account",
    "params": {
        "signature":"RI1PTmjTgr5Ig1p....AF7ejFUGxwKQ==",
        "uuid": "258a2184-2842-b485-25ca-293525152425",
        "data": {
            "notificationid":"35673567",
            "messageid":"453455465",
            "orderid":"3473567567",
            "accountid":"1234567890",
            "verified":"1",
            "attributes":
            {
                "clearinghouse":"SWEDEN",
                "bank":"SEB",
                "descriptor":"**** *084057",
                "lastdigits":"084057"
            }
        }
    },
    "version": "1.1"
}

Response

Valid responses are:

StatusDescription
OKThe notification has been received.


Example

Example of OK response:

Response
{
    "result": {
        "signature": "R9+hjuMqbsH0Ku ... S16VbzRsw==",
        "uuid": "258a2184-2842-b485-25ca-293525152425",
        "method": "account",
        "data": {
            "status": "OK"
        }
    },
    "version":"1.1"
}