NAV Navbar
cURL unsigned cURL signed

Payment notifications

Payment details updated

Object sent to the notificationUrl address provided by the Partner:

{
    "paymentId": "PAY815576576741391",
    "externalPaymentId": "121/06/2018",
    "code": "PAYMENT_DETAILS_UPDATED",
    "type": "PAYMENT",
    "acquirerResponse": "APPROVED",
    "amount" : {
        "value": 15.58,
        "currency": "EUR"
    },
    "authorisationCode": "235006",
    "creationDate": "2020-02-07T08:12:12.468Z",
    "issuerCountry": "PL",
    "issuerId": "489108",
    "issuerName": "ING Bank",
    "merchantReference": "326078790",
    "paymentMethod": "visa",
    "paymentMethodVariant": "visaclassic",
    "rawAcquirerResponse": "Success",
    "shopperPAN": "9389"
}

or

{
    "paymentId": "PAY815576576741391",
    "externalPaymentId": "121/06/2018",
    "code": "PAYMENT_DETAILS_UPDATED",
    "type": "PAYMENT",
    "cardGroup": "VISA",
    "cardGroupType": "CREDIT",
    "cardIssuingCountry": "US",
    "cardIssuingCurrency": "EUR",
    "cardIssuingBank": "TEST BANK",
    "cardBin": "411111",
    "cardSummary": "1111",
    "cardExpiryDate": "3/2030"
}

or

{
    "paymentId": "PAY815576576741391",
    "externalPaymentId": "121/06/2018",
    "code": "PAYMENT_DETAILS_UPDATED",
    "type": "PAYMENT",
    "shopperFirstName": "John",
    "shopperLastName": "Kowalsky",
    "shopperEmail": "[email protected]",
    "shopperExternalStatus": "VERIFIED",
    "shopperExternalId": "PRQG2AMSDMSW8",
    "shopperPhone": "654852693",
    "shopperCountry": "EN"
}
eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImN0eSI6ImFwcGxpY2F0aW9uL2pzb24iLCJraWQiOiJ6QzRqNEFjaGR6d0tYU19NcXNoNEFmd1Z5U3VHc0ZnZ09fMnh2NXR1c3prIn0.eyJwYXltZW50SWQiOiJQQVk4MTU1NzY1NzY3NDEzOTEiLCJleHRlcm5hbFBheW1lbnRJZCI6IjEyMS8wNi8yMDE4IiwiY29kZSI6IlBBWU1FTlRfREVUQUlMU19VUERBVEVEIiwidHlwZSI6IlBBWU1FTlQiLCJhY3F1aXJlclJlc3BvbnNlIjoiQVBQUk9WRUQiLCJhbW91bnQiOnsidmFsdWUiOjE1LjU4LCJjdXJyZW5jeSI6IkVVUiJ9LCJhdXRob3Jpc2F0aW9uQ29kZSI6IjIzNTAwNiIsImNyZWF0aW9uRGF0ZSI6IjIwMjAtMDItMDdUMDg6MTI6MTIuNDY4WiIsImlzc3VlckNvdW50cnkiOiJQTCIsImlzc3VlcklkIjoiNDg5MTA4IiwiaXNzdWVyTmFtZSI6IklORyBCYW5rIiwibWVyY2hhbnRSZWZlcmVuY2UiOiIzMjYwNzg3OTAiLCJwYXltZW50TWV0aG9kIjoidmlzYSIsInBheW1lbnRNZXRob2RWYXJpYW50IjoidmlzYWNsYXNzaWMiLCJyYXdBY3F1aXJlclJlc3BvbnNlIjoiU3VjY2VzcyIsInNob3BwZXJQQU4iOiI5Mzg5In0.CdCd709u5ZRqDh6PYsL852o9R3fPdpwwh1Hi35rJ_7NMon_vEvGR6B-582y7D-4l9cKvVqS94kA_MjXJYbJ8xr8U480l7AoZjZxwDmJ1-XnHNUW-cLV95wNqrIEuxIwWZZOOWITHtDUnm26eNTYXaMXO3y4PZmNm-9agwbrPdk8WxRtwiSSinAWDXq_Zy0FfuNDl8U1ecxn7GIxAqTQchWee149yVaZXffInHhhrv8-LQEaueQ0l1BUa3FDWuz2gV7d1QJqHl4v5xihcByxTaaYLQfhA88Kk_Xa_2-LBqDfSUKWOayTfpvdk3PyhSNfxVy4IU4r4mr3uZKvCP0dTeQ

or

eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImN0eSI6ImFwcGxpY2F0aW9uL2pzb24iLCJraWQiOiJ6QzRqNEFjaGR6d0tYU19NcXNoNEFmd1Z5U3VHc0ZnZ09fMnh2NXR1c3prIn0.eyJwYXltZW50SWQiOiJQQVk4MTU1NzY1NzY3NDEzOTEiLCJleHRlcm5hbFBheW1lbnRJZCI6IjEyMS8wNi8yMDE4IiwiY29kZSI6IlBBWU1FTlRfREVUQUlMU19VUERBVEVEIiwidHlwZSI6IlBBWU1FTlQiLCJjYXJkR3JvdXAiOiJWSVNBIiwiY2FyZEdyb3VwVHlwZSI6IkNSRURJVCIsImNhcmRJc3N1aW5nQ291bnRyeSI6IlVTIiwiY2FyZElzc3VpbmdDdXJyZW5jeSI6IkVVUiIsImNhcmRJc3N1aW5nQmFuayI6IlRFU1QgQkFOSyIsImNhcmRCaW4iOiI0MTExMTEiLCJjYXJkU3VtbWFyeSI6IjExMTEiLCJjYXJkRXhwaXJ5RGF0ZSI6IjMvMjAzMCJ9.b7SWTLH1CcW6oWWVn03iIUbF8o7OiW9L5LLctIsm6PNp_IwYfgwqgI8fHk_Covb10E_ni2sUHSyfolJdmiqJcxkwlo59uwoqOIpVpv1PLh_RqLHT75C82OLecHZfXPyb8vvDM9aKKp1At9gyRX1qAlyY2t4E9jDzPco8tCQ7guYSifN7DJbLBKYXqQxULNW6bwnzQJytGmfS8jxD_PxXmzLbQMkgtKPRrKjCo--xOqPS4As_wIb9Jo2JVOHRE-7iWy3Ac3NcElIAuPSH94NC0yvicuHBALlamCN2b75HkUmAvtiejEl9T_jQxkZSB892GuWUuC9eMNJgvmqE9373zQ

or

eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImN0eSI6ImFwcGxpY2F0aW9uL2pzb24iLCJraWQiOiJ6QzRqNEFjaGR6d0tYU19NcXNoNEFmd1Z5U3VHc0ZnZ09fMnh2NXR1c3prIn0.eyJwYXltZW50SWQiOiJQQVk4MTU1NzY1NzY3NDEzOTEiLCJleHRlcm5hbFBheW1lbnRJZCI6IjEyMS8wNi8yMDE4IiwiY29kZSI6IlBBWU1FTlRfREVUQUlMU19VUERBVEVEIiwidHlwZSI6IlBBWU1FTlQiLCJzaG9wcGVyRmlyc3ROYW1lIjoiSm9obiIsInNob3BwZXJMYXN0TmFtZSI6Iktvd2Fsc2t5Iiwic2hvcHBlckVtYWlsIjoiai5rb3dhbHNreUBjaW5rY2lhcnoucGwiLCJzaG9wcGVyRXh0ZXJuYWxTdGF0dXMiOiJWRVJJRklFRCIsInNob3BwZXJFeHRlcm5hbElkIjoiUFJRRzJBTVNETVNXOCIsInNob3BwZXJQaG9uZSI6IjY1NDg1MjY5MyIsInNob3BwZXJDb3VudHJ5IjoiRU4ifQ.beptx8cV2JkT9mlI0-lrYh_LbrWGxjGrbPt65O0dkppH377vU7BQwnCdC-McPTcPjTTq_0W3bOi0xO6LUNKtl3HuodX4BlRS57fbu5hcN-GdbC1V9W1wXbvHeXo0PVJCY99eTYTCdCYFFYovCVj_xjHE2FPKmpFBPDLK5C1II2GKqUl35TVOeup1iLOLtlEyDx__csm22C4eTXN1SZU1Mo6eAcO00yDjtZwIv6O8y81P1vqkNFWumaKMljATECIMTRHe4-s3NDzu_paSFxyq6WS4skgZG-WTswW04PsngJjl0eEx1cPnJVTYpPxgQHZlBui3Zdj73EXQQT54DYHmrw

Request headers:

Content-Type: application/json
Content-Type: application/jose+json

This payment notification will be sent to the Partner after the Conotoxia Pay system receives the necessary information from external payment systems. The data sent to the Partner depends on the selected payment method by the customer. This type of notification may be sent multiple times and may contain a different scope of data concerning a given payment. Below is a description of the message parameters, which is sent to the Partner.

PaymentDetailsUpdated object

Field name Type Required Limit Description
paymentId String YES max. 40 characters Payment identifier in the Conotoxia Pay system.
externalPaymentId String YES max. 64 characters Payment identifier in the Partner system.
code String YES max. 14 characters This notification has value PAYMENT_DETAILS_UPDATED.
type String YES max. 7 characters Notification type. Value for payment PAYMENT.
additionalParameters Object NO max. 1024 characters Additional parameters defined in create payment request.
acquirerResponse String NO max. 30 characters Normalized response from the acquirer (not necessarily the final status of the payment).
amount Amount NO Amount of the payment (authorisation amount).
authorisationCode String NO max. 50 characters Authorisation code returned for a successful payment.
creationDate String NO Date and time (according to ISO 8601 format YYYY-MM-ddTHH:mm:ss.fffZ)
issuerCountry String NO max. 2 characters ISO country code of the issuer.
issuerId String NO max. 30 characters Unique identifier of the issuer. In case of card payments this will be the issuer BIN (first 6 digits of the card number).
issuerName String NO max. 256 characters Name of the issuing bank, if available.
merchantReference String NO max. 80 characters Reference number that was provided when initiating the payment request.
paymentMethod String NO max. 30 characters Payment method type of the payment which was processed. For example: visa, mc, amex.
paymentMethodVariant String NO max. 32 characters Payment method sub-brand, or the main payment method if not available (e.g. mccredit or visagold).
rawAcquirerResponse String NO max. 256 characters Raw response we receive from the acquirer, where available.
shopperPAN String NO max. 80 characters Account number of the shopper or consumer. In case of card payments, the last four digits of the card number.
shopperFirstName String NO First name.
shopperLastName String NO Last name.
shopperEmail String NO Email.
shopperExternalStatus String NO External status.
shopperExternalId String NO External identifier.
shopperPhone String NO Phone number.
cardGroup String NO Card group.
cardGroupType String NO Card group type.
cardIssuingBank String NO Card issuing bank.
cardIssuingCountry String NO Card issuing country.
cardIssuingCurrency String NO Currency of the issued card.
cardBin String NO Card BIN.
cardSummary String NO Card summary.
cardExpiryDate String NO Card expiry date.

Amount

Field name Type Required Limit Description
value Number YES Amount. Max. 19 characters with support for 2 places after the decimal separator (a dot (.) is used as the decimal separator). The number of places after the decimal separator depends on the currency and is given in the List of supported currencies.
currency String YES 3 characters Currency code according to ISO 4217. Allowed currency codes are defined in the List of supported currencies.

List of supported currencies

Currency Currency code Number of digits after the decimal separator Minimum currency units for a transaction
United Arab Emirates Dirham AED 2 1
Australia Dollar AUD 2 1
Bulgaria Lev BGN 2 1
Canada Dollar CAD 2 1
Switzerland Franc CHF 2 1
China Yuan Renminbi CNY 2 1
Czech Republic Koruna CZK 2 10
Denmark Krone DKK 2 10
Euro EUR 2 1
United Kingdom Pound GBP 2 1
Hong Kong Dollar HKD 2 1
Hungary Forint HUF 0 100
Israeli New Sheqel ILS 2 1
Japan Yen JPY 0 100
Mexico Peso MXN 2 1
Norway Krone NOK 2 10
New Zealand Dollar NZD 2 1
Poland Zloty PLN 2 1
Romania New Leu RON 2 1
Sweden Krona SEK 2 10
Singapore Dollar SGD 2 1
Turkey Lira TRY 2 1
United States Dollar USD 2 1
South Africa Rand ZAR 2 1
Thailand Baht THB 2 100
Serbian dinar RSD 2 10

Algorithm for sending notifications

Unsuccessful attempts Next attempt in
1 5 seconds
2 - 11 10 seconds
12 - 20 600 seconds
21 - 110 1800 seconds
> 110 No more attempts