Skip to content

Examples

In this section, there are some Webhook notifications examples sent by SIBS Gateway, and the expected answer that the Merchant should give.
(More information in section Webhook Notification Response).

Notification

The answer to this message is crucial to avoid more unnecessary notifications sent by SIBS Gateway through the Webhook Retry System (more information in section Merchant Notification Retry System).

1. Webhook Notification Response
2. Webhook Notification Decryption
3. MB WAY Purchase with Alias
4. MB WAY Purchase with Alias – Declined
5. MB WAY Authorised Payment Creation
6. MB WAY Authorised Payment Purchase after Creation
7. Cancel MB WAY Authorised Payment
8. Cancel MB WAY Authorised Payment – Decline
9. Static QR Code Purchase
10. MULTIBANCO Reference Generation
11. MULTIBANCO Reference “Paid”
12. Card Purchase
13. Token Generation
14. Token Purchase
15. Merchant Initiated Transaction (MIT) with Type UCOF
16. Merchant Initiated Transaction (MIT) with Type Recurring
17. Cardholder Initiated Transaction (CIT) with Type UCOF
18. Cardholder Initiated Transaction (CIT) with Type Recurring
1. Webhook Notification Response
{
    "statusCode": "200",
    "statusMsg": "Success",
    "notificationID": "93b9b3a6-602f-4769-8158-48ae9c380ed5"
}
2. Webhook Notification Decryption
{
    “$cypher_algo = 'AES-256-GCM';
    $key = convert_encode($webhookSecret);
    $iv = convert_encode($iv_from_http_header);
    $auth = convert_encode($auth_tag_from_http_header);
    $data = convert_encode($http_body);
    $result = openssl_decrypt($data, $cypher_algo, $key, OPENSSL_RAW_DATA, $iv, $auth);”
}
3. MB WAY Purchase with Alias
{
    "returnStatus": {
        "statusMsg": "Success",
        "statusCode": "000"
    },
    "paymentStatus": "Success",
    "paymentMethod": "MBWAY",
    "transactionID": "s2efgrtgn456477",
    "transactionDateTime": "2022-11-11T16:18:53.127Z ",
    "amount": {
        "currency": "EUR",
        "value": "16.20"
    },
    "merchant": {
        "transactionId": "863b730df285443ca404e0085fw234",
        "terminalId": "99978",
        "merchantName": "Teste MBWAY Sucesso",
        "inApp": "false"
    },
    "paymentType": "PURS",
    "token": {
        "tokenType": "MobilePhone",
        "value": "351#912345678"
    },
    "internalTransactionId": "S14073500001359S",
    "notificationID": "839ca363-8581-4b9f-8041-a6dfgrtyu643"
}
4. MB WAY Purchase with Alias – Declined
{
    "returnStatus": {
        "statusMsg": "Declined",
        "statusCode": "01.106.0004"
    },
    "paymentStatus": "Declined",
    "paymentMethod": "MBWAY",
    "transactionID": "s2nvtgbntiuybn88485t",
    "transactionDateTime": "2022-11-11T16:18:53.127Z ",
    "amount": {
        "currency": "EUR",
        "value": "16.20"
    },
    "merchant": {
        "transactionId": "863b730df285443ca404e00853de45",
        "terminalId": "99978",
        "merchantName": "Teste MBWAY Erro",
        "inApp": "false"
    },
    "paymentType": "PURS",
    "token": {
        "tokenType": "MobilePhone",
        "value": "351#912345500"
    },
    "internalTransactionId": "S14073500001351S",
    "notificationID": "839ca363-8581-4b9f-8041-a6d456jkh678"
}
5. MB WAY Authorised Payment Creation
{
    "returnStatus": {
    "statusMsg": "Success",
    "statusCode": "000"
    },
    "paymentStatus": "Success",
    "paymentMethod": "MBWAY",
    "transactionID": "UpxBSsjySqaR80aEzWxa",
    "transactionDateTime": "2022-11-11T16:18:53.127Z",
    "amount": {
        "currency": "EUR",
        "value": 1.96
    },
    "merchant": {
        "transactionId": "1009854",
        "terminalId": 45546,
        Notification: Restricted Version 2024.11 of 2024-11-11
        Reference: Page 125 of 151
        SIBS Gateway V2 Integration Manual
        “merchantName”: “Test Authorised Payment Creation”,
        “inApp”: “false”
    },
    "paymentType": "AUTH",
    "mbwayMandate": {
        "mandateIdentification": "12345690656800744652",
        "mandateAction": "CRTN",
        "mandateActionStatus": "SCCS",
        "mandateType": "SBSC",
        "clientName": "Andresa COS",
        "aliasMBWAY": "351#914341580"
    },
    "notificationID": "6e96b74f-ec33-4ca9-8cd3-1d00c5d82a0d"
}
6. MB WAY Authorised Payment Purchase after Creation
{
    "returnStatus": {
        "statusMsg": "Success",
        "statusCode": "000"
    },
    "paymentStatus": "Success",
    "paymentMethod": "MBWAY",
    "transactionID": "s2jrfvnriuv8tgt554tg",
    "transactionDateTime": "2022-11-11T16:18:53.127Z ",
    "amount": {
        "currency": "EUR",
        "value": 15.2
    },
    "merchant": {
        "transactionId": "863b730df285443ca404e0085dref45",
        "terminalId": 99978,
        "merchantName": "Teste Pagamentos Autorizados Sucesso"
    },
    "paymentType": "PURS",
    "token": {
        "tokenType": "MobilePhone",
        "value": "351#919992314"
    },
    "internalTransactionId": "S13074000497973S",
    "notificationID": "839ca363-8581-4b9f-8041-a45tgbh67u"
}
7. Cancel MB WAY Authorised Payment
{
    "returnStatus": {
        "statusMsg": "Success",
        "statusCode": "000"
    },
    "paymentStatus": "Success",
    "paymentMethod": "MANDATE",
    "transactionID": "s2t44gh56y67jAsftgt",
    "transactionDateTime": "2022-11-11T16:18:53.127Z ",
    "amount": {
        "currency": "EUR",
        "value": 15.2
    },
    "merchant": {
        "transactionId": "863b730df285443ca404e0085fd6789",
        "terminalId": 96546,
        "merchantName": "Canc Pagamento Autorizado"
    },
    "paymentType": "CAUT",
    "internalTransactionId": "S14072900000002S",
    "notificationID": "0d93a5ef-13e0-4a6b-9e40-652342321451"
}
8. Cancel MB WAY Authorised Payment – Decline
{
    "returnStatus": {
        "statusMsg": "Declined",
        "statusCode": "10.106.2662"
    },
    "paymentStatus": "Declined",
    "paymentMethod": "MANDATE",
    "transactionID": "s2SFFe3445gjn5hjas",
    "transactionDateTime": "2022-11-11T16:18:53.127Z",
    "amount": {
        "currency": "EUR",
        "value": 15.2
    },
    "merchant": {
        "transactionId": "863b730df285443ca404e0085fd6ssd",
        "terminalId": 96546,
        "merchantName": "Canc Pagamento Autorizado"
    },
    "paymentType": "CAUT",
    "internalTransactionId": "S14072900000007S",
    "notificationID": "0d93a5ef-13e0-4a6b-9e40-h589085hnA "
}
9. Static QR Code Purchase
{
    "returnStatus": {
        "statusMsg": "Success",
        "statusCode": "000"
    },
    "paymentStatus": "Success",
    "paymentMethod": "STATIC_QRCODE",
    "transactionID": "3W005000159764",
    "transactionDateTime": "2022-11-12T16:17:53.127Z",
    "amount": {
        "currency": "EUR",
        "value": 1.6
    },
    "merchant": {
        "terminalId": 46431
    },
    "paymentType": "PURS",
    "financialOperation": {
        "product": {
            "staticQRCodeId": "7ecf9d4e23334f7da6cb",
            "twoStepPurchase": false,
            "aliasName": "351#934885128",
            "merchantContactType": "NA",
            "productName": "Nome info",
            "productQuantity": 1,
            "productAmount": 1.5,
            "expeditionAmount": 0.1,
            "contactClientIndicator": 1,
            "customerSupportContact": "teste@info.com"
        },
        "billingInfo": {
            "billingTIN": "123456789",
            "billingAddressCity": "Lisboa ",
            "billingAddressLine1": "Rua D João ",
            "billingAddressLine2": "8 2drt",
            "billingAddressPostalCode": "4646-846",
            Classification: Restricted Version 2024.11 of 2024-11-11
            Reference: Page 124 of 151
            SIBS Gateway V2 Integration Manual
            "billingMobilePhone": "+ 351 987654321"
        },
        "expeditionInfo": {
            "expeditionName": "Olga Rodrigues",
            "expeditionAddressCity": "Lisboa ",
            "expeditionAddressLine1": "Rua D João ",
            "expeditionAddressLine2": "8 2drt",
            "expeditionAddressPostalCode": "4646-846",
            "expeditionMobilePhone": "+ 351 987654321"
        }
    },
    "notificationID": "5544b042-8b9a-451e-8421-53fcfe9538f8"
}
10. MULTIBANCO Reference Generation
{
    "returnStatus": {
        "statusMsg": "Success",
        "statusCode": "000"
    },
    "paymentStatus": "Success",
    "paymentMethod": "REFERENCE",
    "transactionID": "s24587y857mtjgnbt",
    "transactionDateTime": "2022-12-23T10:48:39.153Z ",
    "amount": {
        "currency": "EUR",
        "value": "20.0"
    },
    "merchant": {
        "transactionId": "863b730df285443ca404e008sde23",
        "terminalId": "88845",
        "merchantName": "Teste Referências, Lda"
    },
    "paymentReference": {
        "reference": "256309828",
        "entity": "40200",
        "paymentEntity": "40200",
        "amount": {
        "value": "20.0",
        "currency": "EUR"
    },
    "status": "UNPAID",
    "expiryDate": "2022-01-23T10:48:39.153Z "
    },
    "paymentType": "PREF",
    "notificationID": "20273954-0540-4bd3-8e01-234eds234cds"
}
11. MULTIBANCO Reference “Paid”
{
    "returnStatus": {
        "statusMsg": "Success",
        "statusCode": "000"
    },
    "paymentStatus": "Success",
    "paymentMethod": "REFERENCE",
    "transactionID": "s2jfvbiurbg8956vng",
    "transactionDateTime": "2022-12-23T10:48:39.153Z",
    "amount": {
        "currency": "EUR",
        "value": 20
    },
    "merchant": {
        "transactionId": "863b730df285443ca404e00823sh76",
        "terminalId": 88845,
        "merchantName": "Teste Referências, Lda"
    },
    "paymentType": "PREF",
    "internalTransactionId": "S14073000000341S",
    "notificationID": "20273954-0540-4bd3-8e0-asd2w4jo0mmt"
}
12. Card Purchase
{
    "returnStatus": {
        "statusMsg": "Success",
        "statusCode": "000"
    },
    "paymentStatus": "Success",
    "paymentMethod": "CARD",
    "transactionID": "s2shdvbevr76756er",
    "transactionDateTime": "2022-11-11T16:18:53.127Z",
    "amount": {
        "currency": "EUR",
        "value": 19.2
    },
    "merchant": {
        "transactionId": "863b730df285443ca404e008456sw2",
        "terminalId": 66645,
        "merchantName": "Teste Cartões, Lda"
    },
    "paymentType": "PURS",
    "internalTransactionId": "S14073000000711S",
    "notificationID": "8ec13f91-0129-44ff-980c-79e456fds21s"
}
13. Token Generation
{
    "returnStatus": {
        "statusMsg": "Success",
        "statusCode": "000"
    },
    "paymentStatus": "Success",
    "paymentMethod": "CARD",
    "transactionID": "sandboxfghwTKNGEN000",
    "transactionDateTime": "2022-11-11T16:18:53.127Z ",
    "amount": {
        "currency": "EUR",
        "value": 19.2
    },
    "merchant": {
        "transactionId": "863b730df285443ca404e008dsw212",
        "terminalId": 77745,
        "merchantName": "GOMERCIANTE DO LEGACY LD"
    },
    "paymentType": "AUTH",
    "token": {
        "tokenType": "Card",
        "value": "fjklvnrtinrt435356jv"
    },
    "internalTransactionId": "S13074000501340S",
    "notificationID": "462ec85b-5e1a-4a00-a4d7-97ddfe321567"
}
14. Token Purchase
{
    "returnStatus": {
        "statusMsg": "Success",
        "statusCode": "000"
    },
    "paymentStatus": "Success",
    "paymentMethod": "TOKEN",
    "transactionID": "s2grnvtruigbitu845hhtn",
    "transactionDateTime": "2022-11-11T16:18:53.127Z ",
    "amount": {
        "currency": "EUR",
        "value": 19.2
    },
    "merchant": {
        "transactionId": "863b730df285443ca404e008mvn432kop",
        "terminalId": 77745,
        "merchantName": "PETROLEOS DE PORTUGAL - PETROGAL, SA"
    },
    "paymentType": "PURS",
    "token": {
        "tokenType": "Card",
        "value": "gbtyhyujyuikuier45646ger4"
    },
    "notificationID": "462ec85b-5e1a-4a00-a4d7-97d345fds234"
}
15. Merchant Initiated Transaction (MIT) with Type UCOF
{
    "returnStatus": {
        "statusMsg": "Success",
        "statusCode": "000"
    },
    "paymentStatus": "Success",
    "paymentMethod": "CARD",
    "transactionID": "s2nYaNUC3hFpqd0HGq4Z",
    "transactionDateTime": "2022-12-23T10:48:39.153Z",
    "amount": {
        "currency": "EUR",
        "value": 5.16
    },
    "merchant": {
        "transactionId": "6540474",
        "terminalId": 45546,
        "merchantName": "GOMERCIANTE DO LEGACY"
    },
    "paymentType": "MITR",
    "notificationID": "c9786e7e-dc2a-4611-8a31-4b8197f41138",
    "merchantInitiatedTransaction": {
        "type": "UCOF",
        "amountQualifier": "ESTIMATED"
    }
}
16. Merchant Initiated Transaction (MIT) with Type Recurring
{
    "returnStatus": {
        "statusMsg": "Success",
        "statusCode": "000"
    },
    "paymentStatus": "Success",
    "paymentMethod": "CARD",
    "transactionID": "s2K9YuqPQuC9NkdCvDA4",
    "transactionDateTime": "2023-01-06T00:00:03.378Z",
    "amount": {
        "currency": "EUR",
        "value": 11.2
    },
    "merchant": {
        "terminalId": 45546,
        "merchantName": "GOMERCIANTE DO LEGACY"
    },
    "paymentType": "MITR",
    "notificationID": "3a9d8777-292d-48fb-971c-6e6558de0fd5",
    "merchantInitiatedTransaction": {
        "type": "RCRR",
        "amountQualifier": "ACTUAL"
    }
}
17. Cardholder Initiated Transaction (CIT) with Type UCOF
{
    "returnStatus": {
        "statusMsg": "Success",
        "statusCode": "000"
    },
    "paymentStatus": "Success",
    "paymentMethod": "CARD",
    "transactionID": "s2bDX8mjiFZU5ZwfvSvR",
    "transactionDateTime": "2023-01-06T16:57:11.2Z",
    "amount": {
        "currency": "EUR",
        "value": 102.38
    },
    "merchant": {
        "transactionId": "3064371",
        "terminalId": 45546,
        "merchantName": "GOMERCIANTE DO LEGACY"
    },
    "paymentType": "AUTH",
    "notificationID": "45d108d3-2cef-41a6-90af-a3bdb4af244a",
    "merchantInitiatedTransaction": {
        "type": "UCOF",
        "validityDate": "2023-01-31T00:00:00Z",
        "amountQualifier": "ESTIMATED"
    }
}
18. Cardholder Initiated Transaction (CIT) with Type Recurring
{
    "returnStatus": {
        "statusMsg": "Success",
        "statusCode": "000"
    },
    "paymentStatus": "Success",
    "paymentMethod": "CARD",
    "transactionID": "s24nZiFtu15SCiW9vpDm",
    "transactionDateTime": "2022-12-27T16:05:27.585Z",
    "amount": {
        "currency": "EUR",
        "value": 11.2
    },
    "merchant": {
        "transactionId": "6637262",
        "terminalId": 45546,
        "merchantName": "GOMERCIANTE DO LEGACY"
    },
    "paymentType": "PURS",
    "notificationID": "a433453e-6e40-4f53-a80d-4985cffa36f6",
    "merchantInitiatedTransaction": {
        "type": "RCRR",
        "validityDate": "2023-06-30T01:00:00+01:00",
        "amountQualifier": "ACTUAL",
        "schedule": {
            "initialDate": "2022-12-27T00:00:00Z",
            "finalDate": "2023-01-06T00:00:00Z",
            "interval": "DAILY"
        }
    }
}
Privacy Overview

This website uses cookies so that we can provide you with the best user experience possible. Cookie information is stored in your browser and performs functions such as recognising you when you return to our website and helping our team to understand which sections of the website you find most interesting and useful.

Strictly Necessary Cookies

Strictly Necessary Cookie should be enabled at all times so that we can save your preferences for cookie settings.

If you disable this cookie, we will not be able to save your preferences. This means that every time you visit this website you will need to enable or disable cookies again.