Skip to Content

Confirm payment transaction

POST /API/XML/InvoiceManagementService.ashx

Not available in the sandbox. The platform describes this method, but the mock does not implement it: a request with this root element gets HTTP 400 and ResultCode 400 with Unknown operation element. Sandbox support is planned.

Request parameters

FieldTypeRequiredDescription
Callisto-Protocol-Version2yes
SignatureVersioninteger (int32, default 1)—

Request body

FieldTypeRequiredDescription
ConfirmPaymentTransactionRequestobjectyes
ConfirmPaymentTransactionRequest.ProjectIDinteger (int32)yesProject ID in the Platform system. Assigned during project setup.
ConfirmPaymentTransactionRequest.ClientIPstring—
ConfirmPaymentTransactionRequest.InvoiceInfoobjectyes
ConfirmPaymentTransactionRequest.InvoiceInfo.AdditionalParametersobject—
ConfirmPaymentTransactionRequest.InvoiceInfo.AdditionalParameters.Parameterobject[]—
ConfirmPaymentTransactionRequest.InvoiceInfo.InvoiceIDstring (uuid)—Unique Invoice ID assigned by the Platform
ConfirmPaymentTransactionRequest.InvoiceInfo.MerchantOrderIDstring—Order ID in Merchant’s system
ConfirmPaymentTransactionRequest.PaymentTransactionInfoobjectyes
ConfirmPaymentTransactionRequest.PaymentTransactionInfo.TransactionIDstring—
HeaderobjectyesRequest header with authentication. Included in every API request.
Header.AuthenticationobjectyesRequest authentication data. All three fields are mandatory for every request.
Header.Authentication.LoginstringyesMerchant Login assigned by the Platform
Header.Authentication.NowUtcstringyesCurrent UTC time in yyyyMMddHHmmss format. Must not differ from platform system time by more than 20 minutes.
Header.Authentication.SignaturestringyesHMAC request signature. Calculated as: LOWERCASE(HMACSHA256(Password, Login + LOWERCASE(HMACSHA256(Password, NowUtc))))
Header.RequestAttemptinteger (int32)—Ordinal invoice request number (for idempotency). Starting from 0.
Header.Gatewayobject—Platform service block in the request header. The sandbox does not read it: the block is ignored and affects neither the signature nor processing.
Header.Gateway.Signaturestring—
Header.Gateway.ContractInfoobject—
Header.Gateway.ContractInfo.DesiredExpirationTimeUtcstring (date-time)—