logo
Trustly Docs
BETA

Credit notification

Get updated when customers' bank accounts are credited
Updated 1 month ago

This is a method that Trustly will call on the merchant's system when the merchant's end-user's account balance should be credited (increased). This could for example be when a deposit has been made or a previously requested withdrawal has been cancelled.

For e-commerce merchants, this is when the item should be shipped to the end-user.

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

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

Credit
{
    "method": "credit",
    "params": {
        "signature": "D67hjuMqbsH0Ku ... S16VbzRsw==",
        "uuid": "258a2184-2842-b485-25ca-293525152425",
        "data": {
            "amount": "902.50",
            "currency": "EUR",
            "messageid": "98348932",
            "orderid": "87654567",
            "enduserid": "32123",
            "notificationid": "9876543456",
            "timestamp": "2010-01-20 14:42:04.675645+01",
            "attributes": {}
        }
    },
    "version": "1.1"
}

Valid responses are:

StatusDescription
OKThe request to increase the end-user’s balance has been received.


Example of OK response:

Response
{
    "result": {
        "signature": "D5FjuMqf3H0Ku ... S16VbzR5v==",
        "uuid": "258a2184-2842-b485-25ca-293525152425",
        "method": "credit",
        "data": {
            "status": "OK"
        }
    },
    "version":"1.1"
}