handlePaymentAccountChangedNotification

handlePaymentStateChangedNotificationRequest fields

field (type, required) description

payment
(paymentWithPaymentAccount, required)

Type containing all payment details

payment.merchantID
(stringID, required)

Merchant ID

payment.shopID
(stringID, required)

Shop ID

payment.paymentMethod
(keyStringValuePair, required)

key = ID of the corresponding payment method
value = name of the corresponding payment method

look at 2.1.3.2 Payment Methods and State Notifications

payment.merchantTransactionID
(stringID, required)

Merchant's transaction ID

payment.paymentID
(guid, required)

Kalixa's Unique ID of the payment

There can be multiple payments with Unique ID related to one merchantTransactionID. This is possible in Refunds, or payment retries from a particular customer

payment.userID
(stringID, required)

The customer ID

payment.paymentProvider
(keyStringValuePair)

key = ID
value = name of the provider used for processing the payment

payment.amount
(money, required)

Net amount of the transaction with currency

payment.shopFee
(money)

Fee amount to be paid by the customer

payment.creationType
(keyStringValuePair, required)

It specifies who triggered the transaction

1 = User (Customer)
2 = MerchantOperator
3 = Api (Merchant)
5 = MotoEcom
6 = Provider (Kalixa)

payment.userIP
(IPAddress )

The IP of the customer where the payment request came from

payment.state
(paymentState, required)

contains all the details related to the notified state transition

payment.state.id
(guid, required)

The ID of the payment state

payment.state.definition
(keyStringValuePair, required)

key = ID of the state
value = Name of the state

The merchant should react based on the meaning of these states.

look at 2.1.3.2 Payment Methods and State Notifications

payment.state.createdOn
(dateTime, required)

The date and time when the payment switched to that last state

payment.state.paymentStateDetails
(array of keyValueBasePairs)

Additional state-specific details

payment.isExecuted
(boolean)

Indicates if the payment has reached a credit/debit state indicating that the money transfer has been authorised

payment.baseAmount
(money)

Amount in base accounting currency which can be selected by the merchant during setup (for reporting purposes)

payment.paymentDetails
(array of keyValueBasePairs)

Additional payment method-specific details

payment.paymentAccount
(paymentAccount)

The payment instrument (e.g. credit card) used by the customer to perform the payment

payment.paymentAccount.paymentAccountID
(secureString, required)

The token associated to a credit card number. It can be used to initiate CardOnFile transactions (further details look at 2.2.1 Payment Initiation - Card On File (Tokenization))

Please be aware, this token is created for any account type created in the system

payment.paymentAccount.details
(array of keyValueBasePairs, required)

Additional details could be received per payment account type

handlePaymentStateChangedNotificationRequest.state.paymentStateDetails key-values

key (value type, functionality) value

ProviderResponseCode
(string)

Response code of the provider

key = ProviderResponseCode
value = code

see [Provider Response Codes] (Creation Types)

Used for payment methods: Visa, Visa Debit, Mastercard, Mastercard Debit, Maestro Deposit

ApprovalCode
(string)

Approval code, when transaction gets authorized

key = ApprovalCode
value = code

Used for payment methods: Visa, Visa Debit, Mastercard, Mastercard Debit, Maestro Deposit

handlePaymentStateChangedNotificationRequest.paymentDetails key-values

The below details are used for payment methods: Visa, Visa Debit, Mastercard, Mastercard Debit, Maestro, Bank Transfer, Bank Transfer Withdrawal, Multibanco, Neteller, Neteller Withdrawal, Paysafecard, Trustly, Ticket Premium.

key (value type, functionality) value

ProviderExternalID
(string)

It is the transaction ID from the provider

ShippingName
(string)

Name of the shipping's receiver
key = ShippingName
value = value

ShippingStreet
(string)

Street
key = ShippingStreet
value = value

ShippingCity
(string)

City
key = ShippingCity
value = value

ShippingState
(string)

State or province. Applicable for U.S
key = ShippingState
value = value

ShippingPostalCode
(string)

Postal code
key = ShippingPostalCode
value = value

ShippingCountryCode2
(string)

ISO code of the shipping country
key = ShippingCountryCode2
value = value

ShippingTelephoneNumber
(string)

Telephone number
key = ShippingTelephoneNumber
value = value

handlePaymentStateChangedNotificationResponse fields

field (type, required) description

resultCode
(keyStringValuePair, required)

Details representing the result after the notification handling

Key = ID of the response, please see the table Result Codes (below)
Value = Name of the response, please see the table Result Codes (below)

resultMessage
(string)

A message to be attached to the result of the notification

Result Codes

id name descripton sync notification async notification

0

ProcessedSuccessfully

Notification request processed successfully

No retry

No retry

3

RefusedByRiskManagement

Notification request processed successfully, and the payment is refused by the merchant

No retry
Payment processing will be aborted
(applicable for withdrawals)

No retry

10

ErrorProcessingEvent

Problems occurred when processing the notification request

No retry

Retry
Notification will be rescheduled

📘

Samples

/handlePaymentStateChangedNotificationRequest/Sample notifications

Language
Credentials
Basic
base64
: