დოკუმენტაცია

Get Payment ID

Method to get both single and batch payment IDs

Suggest Edits

Get Single Payment ID

When ImportSinglePaymentOrdersRequestIo is successfull, Bank's digital channel (Internet/Mobile banking; DBI integration service), assigns unique ID to each imported single payment order and returns its value in ImportSinglePaymentOrdersResponseIo, in the PaymentId attribute;
in case connection between client system and Bank's digital channel (Internet/Mobile banking; DBI integration service) is broken before client system gets response, GetSinglePaymentId Web Service can be used to get ID that was assigned by Bank's digital channel (Internet/Mobile banking; DBI integration service) to the imported payment order:

📘

In the GetSinglePaymentId web service the Nonce element in security header is not required!

Payment Order Attribute Formats

Attribute format defines allowed character set and maximal number of characters in the attribute value.
Exclamation mark (!) means that value should contain exactly the specified number of characters; e.g.:

  • '22!S' – value should contain exactly 22 characters that correspond to 'S' charset;
  • '22S' – value can contain up to 22 characters that correspond to 'S' charset;
  • '13n.2n' – digits and decimal point: up to 13 digits before point and up to 2 digits after the point.
Format CodeAllowed Charset
nDigits: 0123456789
ACapital letters of the Latin alphabet: ABCDEFGHIJKLMNOPQRSTUVWXYZ
SCapital letters of the Latin alphabet: ABCDEFGHIJKLMNOPQRSTUVWXYZ
Digits: 0123456789
Characters: / - ? : ( ) . , ` + _ * < > & SPACE
RGeorgian (Unicode, UTF-8) letters: აბგდევზთიკლმნოპჟრსტუფქღყშჩცძწჭხჯჰ
Lower case letters of the Latin alphabet: abcdefghijklmnopqrstuvwxyz
Capital letters of the Latin alphabet: ABCDEFGHIJKLMNOPQRSTUVWXYZ
Digits: 0123456789
Characters: / - ? : ( ) . , ' + space

🚧

Characters < > & must be represented as:

Characters must be represented: "<" as &lt; ">" as &gt; "&"as &amp;

Get Single Payment ID Request Attributes

AttributeTypeComment
singlePaymentRequestIdLong
19n		Single payment request ID that was specified in the import request

Example 1: Get Single Payment ID Request

<soapenv:Envelope
	xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
	xmlns:myg="http://www.mygemini.com/schemas/mygemini"
	xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
	<soapenv:Header>
		<wsse:Security>
			<wsse:UsernameToken>
				<wsse:Username>USERNAME</wsse:Username>
				<wsse:Password>PASSWORD</wsse:Password>
			</wsse:UsernameToken>
		</wsse:Security>
	</soapenv:Header>
	<soapenv:Body>
		<myg:GetSinglePaymentIdRequestIo>
			<myg:singlePaymentRequestId>23160119123213120</myg:singlePaymentRequestId>
		</myg:GetSinglePaymentIdRequestIo>
	</soapenv:Body>
</soapenv:Envelope>

Get Single Payment ID Response Attributes

AttributeTypeComment
PaymentIdStringPayment order ID assigned by Bank's digital channel (Internet/Mobile banking; DBI integration service)

❗️

In Case Specified Single Payment Request ID Is Not Found For A Given Client, Web Service Will Return A SOAP Fault

<s:Envelope
	xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
	<s:Header/>
	<s:Body>
		<s:Fault>
			<faultcode
				xmlns:a="http://www.mygemini.com/schemas/mygemini">a:SINGLE_PAYMENT_REQUEST_NOT_FOUND
			</faultcode>
			<faultstring xml:lang="en">Specified single payment request ID is not found for a current client</faultstring>
		</s:Fault>
	</s:Body>
</s:Envelope>

👍

Example 3: Get Single Payment ID Response

<SOAP-ENV:Envelope
	xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
	xmlns:ns2="http://www.mygemini.com/schemas/mygemini">
	<SOAP-ENV:Header/>
	<SOAP-ENV:Body>
		<ns2:GetSinglePaymentIdResponseIo
			xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
			xmlns:xsd="http://www.w3.org/2001/XMLSchema">
            <ns2:paymentId>541202011</ns2:paymentId>
        </ns2:GetSinglePaymentIdResponseIo>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Get Batch Payment ID

When ImportBatchPaymentOrderRequestIois successfull, Bank's digital channel (Internet/Mobile banking; DBI integration service), assigns unique ID to each imported single payment order and returns its value in ImportBatchPaymentOrdersResponseIo, in the PaymentId attribute;
in case connection between client system and Bank's digital channel (Internet/Mobile banking; DBI integration service) is broken before client system gets response, GetBatchPaymentId Web Service can be used to get ID that was assigned by Bank's digital channel (Internet/Mobile banking; DBI integration service) to the imported payment order:

📘

In the GetBatchPaymentId web service the Nonce element in security header is not required!

Get Batch Payment ID Request Attributes

AttributeTypeComment
batchPaymentRequestIdLong
19n		Batch payment request ID that was specified in the import request

Example 4: Get Batch Payment Payment ID Request

<soapenv:Envelope
	xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
	xmlns:myg="http://www.mygemini.com/schemas/mygemini"
	xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
	<soapenv:Header>
		<wsse:Security>
			<wsse:UsernameToken>
				<wsse:Username>USERNAME</wsse:Username>
				<wsse:Password>PASSWORD</wsse:Password>
			</wsse:UsernameToken>
		</wsse:Security>
	</soapenv:Header>
	<soapenv:Body>
		<myg:GetBatchPaymentIdRequestIo>
			<myg:batchPaymentRequestId>1234321</myg:batchPaymentRequestId>
		</myg:GetBatchPaymentIdRequestIo>
	</soapenv:Body>
</soapenv:Envelope>

Get Batch Payment ID Response Attributes

AttributeTypeComment
BatchIdStringInternal ID of batch assigned by Bank's digital channel (Internet/Mobile banking; DBI integration service)

❗️

In Case Specified Batch Payment Request ID Is Not Found For A Given Client, Web Service Will Return A SOAP Fault

<s:Envelope
	xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
	<s:Header/>
	<s:Body>
		<s:Fault>
			<faultcode
				xmlns:a="http://www.mygemini.com/schemas/mygemini">a:BATCH_PAYMENT_REQUEST_NOT_FOUND
			</faultcode>
			<faultstring xml:lang="en">Specified batch payment request ID is not found for a current client</faultstring>
		</s:Fault>
	</s:Body>
</s:Envelope>

👍

Example 6: Get Batch Payment ID Response

<SOAP-ENV:Envelope
	xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
	xmlns:ns2="http://www.mygemini.com/schemas/mygemini">
	<SOAP-ENV:Header/>
	<SOAP-ENV:Body>
		<ns2:GetBatchPaymentIdResponseIo
			xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
			xmlns:xsd="http://www.w3.org/2001/XMLSchema">
            <ns2:batchId>1339307</ns2:batchId>
        </ns2:GetBatchPaymentIdResponseIo>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Updated 10 months ago