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"
}
eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImN0eSI6ImFwcGxpY2F0aW9uL2pzb24iLCJraWQiOiJ6QzRqNEFjaGR6d0tYU19NcXNoNEFmd1Z5U3VHc0ZnZ09fMnh2NXR1c3prIn0.eyJwYXltZW50SWQiOiJQQVk4MTU1NzY1NzY3NDEzOTEiLCJleHRlcm5hbFBheW1lbnRJZCI6IjEyMS8wNi8yMDE4IiwiY29kZSI6IlBBWU1FTlRfREVUQUlMU19VUERBVEVEIiwidHlwZSI6IlBBWU1FTlQiLCJhY3F1aXJlclJlc3BvbnNlIjoiQVBQUk9WRUQiLCJhbW91bnQiOnsidmFsdWUiOjE1LjU4LCJjdXJyZW5jeSI6IkVVUiJ9LCJhdXRob3Jpc2F0aW9uQ29kZSI6IjIzNTAwNiIsImNyZWF0aW9uRGF0ZSI6IjIwMjAtMDItMDdUMDg6MTI6MTIuNDY4WiIsImlzc3VlckNvdW50cnkiOiJQTCIsImlzc3VlcklkIjoiNDg5MTA4IiwiaXNzdWVyTmFtZSI6IklORyBCYW5rIiwibWVyY2hhbnRSZWZlcmVuY2UiOiIzMjYwNzg3OTAiLCJwYXltZW50TWV0aG9kIjoidmlzYSIsInBheW1lbnRNZXRob2RWYXJpYW50IjoidmlzYWNsYXNzaWMiLCJyYXdBY3F1aXJlclJlc3BvbnNlIjoiU3VjY2VzcyIsInNob3BwZXJQQU4iOiI5Mzg5In0.CdCd709u5ZRqDh6PYsL852o9R3fPdpwwh1Hi35rJ_7NMon_vEvGR6B-582y7D-4l9cKvVqS94kA_MjXJYbJ8xr8U480l7AoZjZxwDmJ1-XnHNUW-cLV95wNqrIEuxIwWZZOOWITHtDUnm26eNTYXaMXO3y4PZmNm-9agwbrPdk8WxRtwiSSinAWDXq_Zy0FfuNDl8U1ecxn7GIxAqTQchWee149yVaZXffInHhhrv8-LQEaueQ0l1BUa3FDWuz2gV7d1QJqHl4v5xihcByxTaaYLQfhA88Kk_Xa_2-LBqDfSUKWOayTfpvdk3PyhSNfxVy4IU4r4mr3uZKvCP0dTeQ

Request headers:

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

This payment notification will be sent to the Partner only after the Conotoxia Pay system has collected all the necessary payment information. 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. 36 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.

Amount

Field name Type Required Limit Description
value Number YES Amount. Max. 21 characters with support for 4 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 znaki 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
Croatia Kuna HRK 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
Russia Ruble RUB 2 10
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 10 seconds
2 20 seconds
3 30 seconds
4 - 300 120 seconds
> 300 No more attempts