Completion Request (Finalization of Preauth)
{{url}}/ecom/execute_request/payments/v1/completion
Completion Request
Input Parameters:
Parameter
Description
Data Format
Mandatory
Example
merchantRequestId
A unique identifier generated by the merchant's system, used to check the operation status if the request resulted in an unknown error or disconnection.
string (36)
Yes
137d9304-0368-11ed-b939-0242ac120002
merchantId
Merchant ID generated in Ecom.
string(36)
Yes
137d9304-0368-11ed-b939-0242ac120002
originalOperationId
The identifier of the pre-authorization operation.
string
Yes
137d9304-0368-11ed-b939-0242ac120002
coinAmount
The completion amount in cents (kopecks).
string
Yes
2500
date
Date and time of the payment.
string
Yes
{{currentdateT}}.00+00:00
notificationUrl
The URL to which the Callback will be sent.
string (1000)
No
https://merchant.notification_url
notificationEncryption
Flag for encrypting Callback data.
string
No
true/false. If the parameter is not passed or passed as false, the data in the Callback will not be encrypted.
merchantComment
Additional information/comment from the merchant regarding the order.
string(255) a-zA-Z0-9 ,.;:@#$%'-=+1,256$
No
merchant Comment id 1258728c1
comment
Additional description of the operation filled in by the merchant's client.
string (1000)
No
///5555.25412
purpose
Payment purpose filled in by the merchant.
string (255)
No
За товар (For goods)
Output Parameters
Parameter
Description
Data Format
Example
type
Transaction type
string
COMPLETION
rrn
RRN number of the transaction in the IPS (Interchange Payment System)
string
2554256963
purpose
Payment purpose
string
За товар (For goods)
comment
Comment
string
тест (test)
coinAmount
Payment amount
int
2000
merchantId
Merchant ID
string
137d9304-0368-11ed-b939-0242ac120002
operationId
Transaction ID
string
1712844596346b9F-WwrWZpq
ecomOperationId
Transaction ID in the Ecom system
string
8c3303e9-7396-43b8-af4e-31d9facdde9b
merchantName
Merchant name
string
KB test terminal
approvalCode
Authorization code
string
39203
status
Transaction status
string
<p>SUСCESS
FAIL
PENDING</p>
transactionType
Transaction type in numerical value
string
196
merchantRequestId
Merchant request ID
string
72837906-f526-4aef-8d11-58d80b44cb75
transactionCurrency
Payment currency
string
980
createDateTime
Payment creation date
string
2024.09.19 15:29:25.675
modificationDateTime
Payment modification date
string
2024.09.19 15:29:25.675
actionCode
Response code
string
0
responseCode
Response details
string
0
description
Response description
string
approved
processingMerchantId
Merchant ID in the PC (Processing Center)
string
AE100000
processingTerminalId
Terminal ID in the PC
string
AE100000
bankCode
Name of the issuing bank
string
BANK_ALLIANCE
paymentSystem
Name of the issuing IPS
string
MasterCard
productType
Terminal product type
string
PURCHASE
paymentServiceType
Payment type
string
CARD/APPLE_PAY/GOOGLE_PAY
notificationEncryption
Flag for encrypting Callback data
string
<p>true/false
If the parameter is not passed or passed as false, the data in the Callback will not be encrypted</p>
preauthOperationId
Pre-authorization ID
string
1712843529623cHAHkmt-G5u
preauthCoinAmount
Pre-authorization amount
int
100
preauthEcomOperationId
ID in the Ecom system under which the pre-authorization operation was created
string
c25ee1cb-a052-439b-b075-bcb632615b11
rrnPreauth
RRN number of the pre-authorization in the IPS
string
123456789
Example Request Body
Example Response Body
Last updated