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

Import Single Payments

Import Single Paymentsss

Suggest Edits

Import Single Payments

Import single payment orders functionality allows external systems to import single payment orders into the bank system. In one call 1 to 10 single payment orders of different types can be imported.

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;

List Of Request Attributes In Import Single Payment

AttributeTypeComment
singlePaymentRequestIdLong
19n		This attribute is optional; When specified, bank system will check whether there is already imported single payment order with the same request ID for the same client via
ImportSinglePaymentOrdersRequestIo or via ImportBatchPaymentOrderRequestIo and if yes – then import will fail.
creditAccountAccountIdentificationIoCredit account. Is not used for treasury transfers; for all other transfer
types this element is mandatory.
debitAccountAccountIdentificationIoWhen importing single payment order this element
is mandatory. When importing batch payment this element should not be used.
documentNumberLong
10n		Integer numbers up to 2147483647 are accepted. In case external system
does not send any value, bank system will generate it automatically based
on timestamp.
amountDecimal
13n.2n		Amount to transfer from debit account.
positionIntegerPosition of Payment Order in request. Is mandatory for both
single and batch payment orders. For batch payments this value is then
returned in GetPaymentOrderStatus so that the calling system is
able to match the provided paymentId-s and paymentStatus-es to each payment
order sent in a batch. For single payments it is used again to
match the paymentOrder data in response to those in request.
additionalDescriptionString
165S – for transfer to other bank in foreign currency;
255R – for other
transfer types.		Additional description. Is not used in transfer to own
account orders.
descriptionString
140S – for transfer to
other bank in foreign
currency;
150R – for other
transfer types.		Description of the payment. Is not used in treasury transfers;
for all other transfer types this element is mandatory.

AccountIdentificationIo Object

AttributeTypeComment
accountNumberString 34S – for creditAccount in transfer to other bank in foreign currency;
22!S – for all other cases.		Account number in IBAN format
(creditAccount in transfer to other bank in foreign currency can have different format)
accountCurrencyCodeString
3!A		Account currency code. For debitAccount
element this is MANDATORY

ImportSinglePaymentOrders Method

MethodDescriptionReturns
ImportSinglePaymentOrdersList of single payment orders
(can be various types)		Returns imported single payment ID

Available payment order types and their XSD element equivalents:

Payment order typexsd element name
Transfer to own account - debit and credit accounts have same currency or have different currencies (currency exchange)TransferToOwnAccountPaymentOrderIo
Transfer within TBC BankTransferWithinBankPaymentOrderIo
Transfer to Other Bank in National CurrencyTransferToOtherBankNationalCurrencyPaymentOrderIo
Transfer to Other Bank in Foreign CurrencyTransferToOtherBankForeignCurrencyPaymentOrderIo
Treasury TransferTreasuryTransferPaymentOrderIo
Treasury Transfer for other person or companyTreasuryTransferPaymentOrderIo

Transfer To Own Account

TransferToOwnAccountPaymentOrderIo type is described here

Transfer to own account payment order has 3 possible scenarios:

  1. Transfer between 2 accounts when the both accounts have the same currency;
  2. Transfer between 2 accounts when the accounts have different currencies:
    a. Sell order – the amount is specified in debit account currency;
    b. Buy order – the amount is specified in credit account currency.

The bank system will decide which of the 3 scenarios should be processed based on amount,
debitAccount and creditAccount elements‘ currencies:

Transfer to own account payment order specifics:
• creditAccount element is mandatory;
• creditAccount element’s accountCurrencyCode is mandatory;
• amount element’s currency must match debitAccount or creditAccount element’s currency.

Example 1: Import Single Payment Orders Transfer To Own Account 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"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
   <soapenv:Header>
   <wsse:Security>
    <wsse:UsernameToken>
      <wsse:Username>USERNAME</wsse:Username>
      <wsse:Password>PASSWORD</wsse:Password>
      <wsse:Nonce>1111</wsse:Nonce>
    </wsse:UsernameToken>
   </wsse:Security>
   </soapenv:Header>
   <soapenv:Body>
      <myg:ImportSinglePaymentOrdersRequestIo>
         <myg:singlePaymentOrder xsi:type="myg:TransferToOwnAccountPaymentOrderIo">
            <!--optional
           <myg:singlePaymentRequestId>231</myg:singlePaymentRequestId>
						-->
            <myg:creditAccount>
               <myg:accountNumber>GE82TB7044436180100003</myg:accountNumber>
               <myg:accountCurrencyCode>USD</myg:accountCurrencyCode>
            </myg:creditAccount>
            <myg:debitAccount>
               <myg:accountNumber>GE48TB7044436080100017</myg:accountNumber>
               <myg:accountCurrencyCode>GEL</myg:accountCurrencyCode>
            </myg:debitAccount>
            <myg:documentNumber>20000</myg:documentNumber>
            <myg:amount>
               <myg:amount>10</myg:amount>
               <myg:currency>USD</myg:currency>
            </myg:amount>
            <myg:position>1</myg:position>
            <myg:description>Transfer to Own Account</myg:description>
         </myg:singlePaymentOrder>
         </myg:ImportSinglePaymentOrdersRequestIo>	  
   </soapenv:Body>
</soapenv:Envelope>

Transfer Within Bank

TransferWithinBankPaymentOrderIo type is described here

Transfer within bank payment order specifics:

creditAccount element is mandatory, but it’s accountCurrencyCode element is not used.

AttributeTypeComment
beneficiaryNameStringCredit account owner name
beneficiaryTaxCodeString 11nTax code (when beneficiary is company) or personal number (when beneficiary is individual person) of credit account owner. This attribute is optional, but in case it is specified, bank system will check and accept order only if the specified credit account really belongs to the company/person that has the specified tax code/personal number.

Example 2: Import Single Payment Orders Transfer Within Bank 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" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
   <soapenv:Header>
   <wsse:Security>
    <wsse:UsernameToken>
      <wsse:Username>USERNAME</wsse:Username>
      <wsse:Password>PASSWORD</wsse:Password>
      <wsse:Nonce>1111</wsse:Nonce>
    </wsse:UsernameToken>
   </wsse:Security>
   </soapenv:Header>
   <soapenv:Body>
   <myg:ImportSinglePaymentOrdersRequestIo>
      <myg:singlePaymentOrder xsi:type="myg:TransferWithinBankPaymentOrderIo">
         <!--optional
           <myg:singlePaymentRequestId>231</myg:singlePaymentRequestId>
						-->
            <myg:creditAccount>
               <myg:accountNumber>GE72TB7630636010100004</myg:accountNumber>
            </myg:creditAccount>
            <myg:debitAccount>
               <myg:accountNumber>GE48TB7044436080100017</myg:accountNumber>
               <myg:accountCurrencyCode>GEL</myg:accountCurrencyCode>
            </myg:debitAccount>
            <myg:documentNumber>200002</myg:documentNumber>
            <myg:amount>
               <myg:amount>2</myg:amount>
               <myg:currency>GEL</myg:currency>
            </myg:amount>
            <myg:position>3</myg:position>
            <myg:additionalDescription>Transfer within TBC Bank Example</myg:additionalDescription>
            <myg:description>Transfer within TBC Bank</myg:description>
            <myg:beneficiaryName>Some Company Ltd</myg:beneficiaryName>
         </myg:singlePaymentOrder>
         </myg:ImportSinglePaymentOrdersRequestIo>	  
   </soapenv:Body>
</soapenv:Envelope>

Transfer To Other Bank In National Currency

TransferToOtherBankNationalCurrencyPaymentOrderIo type is described here.

Transfer to other bank in national currency payment order specifics:

  • creditAccount element is mandatory, but it’s accountCurrencyCode element is not used;
  • amount element’s currency must be GEL.
AttributeTypeComment
beneficiaryNameString
70R		Credit account owner name
beneficiaryTaxCodeString
11n		Tax code or personal number of credit account owner.

Example 3: Import Single Payment Orders Transfer To Other Bank National Currency

<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" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
   <soapenv:Header>
   <wsse:Security>
    <wsse:UsernameToken>
      <wsse:Username>USERNAME</wsse:Username>
      <wsse:Password>PASSWORD</wsse:Password>
      <wsse:Nonce>1111</wsse:Nonce>
    </wsse:UsernameToken>
   </wsse:Security>
   </soapenv:Header>
   <soapenv:Body>
      <myg:ImportSinglePaymentOrdersRequestIo>
         <myg:singlePaymentOrder xsi:type="myg:TransferToOtherBankNationalCurrencyPaymentOrderIo">
           <!--optional
           <myg:singlePaymentRequestId>231</myg:singlePaymentRequestId>
						-->
            <myg:creditAccount>
               <myg:accountNumber>GE33BG0000000263255500</myg:accountNumber>
            </myg:creditAccount>
            <myg:debitAccount>
               <myg:accountNumber>GE48TB7044436080100017</myg:accountNumber>
               <myg:accountCurrencyCode>GEL</myg:accountCurrencyCode>
            </myg:debitAccount>
            <myg:documentNumber>200003</myg:documentNumber>
            <myg:amount>
               <myg:amount>2</myg:amount>
               <myg:currency>GEL</myg:currency>
            </myg:amount>
            <myg:position>4</myg:position>
            <myg:additionalDescription>Transfer to Other Bank in NC Example</myg:additionalDescription>
            <myg:description>Transfer to Other Bank in National Currency</myg:description>
            <myg:beneficiaryName>Some Company Ltd</myg:beneficiaryName>
            <myg:beneficiaryTaxCode>100200300</myg:beneficiaryTaxCode>
         </myg:singlePaymentOrder>
         </myg:ImportSinglePaymentOrdersRequestIo>	  
   </soapenv:Body>
</soapenv:Envelope>

Transfer To Other Bank In Foreign Currency

TransferToOtherBankForeignCurrencyPaymentOrderIo is described here.

Transfer to other bank in foreign currency payment order specifics:

  • creditAccount element is mandatory, but it’s accountCurrencyCode element is not used;
  • amount element’s currency must be the same as debitAccount element‘s currency;
  • Summary length of (beneficiaryName + ' ' + beneficiaryAddress) should not exceed 140
    characters.
AttributeTypeComment
beneficiaryNameString
140S *		Credit account owner name
beneficiaryAddressString
140S *		Credit account owner country
beneficiaryBankCodeString
34S		Beneficiary bank identification code
beneficiaryBankNameString
140S		Beneficiary bank name (optional if bank
SWIFT code is specified)
intermediaryBankCodeString
34S		Intermediary bank identification code
intermediaryBankNameString
140S		Intermediary bank name (optional if intermediary bank
SWIFT code is specified or code is not specified at all)
chargeDetailsString
3!A		Defines types of charges that can be used for SWIFT payments. it may have two values:
SHA - Beneficiary will receive amount reduced by intermediary bank’s fee
OUR - Beneficiary will receive full amount, you will pay additional 20USD/30EUR

Example 4: Import Single Payment Orders Transfer To Other Bank Foreign Currency

<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"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
   <soapenv:Header>
   <wsse:Security>
    <wsse:UsernameToken>
      <wsse:Username>USERNAME</wsse:Username>
      <wsse:Password>PASSWORD</wsse:Password>
      <wsse:Nonce>1111</wsse:Nonce>
    </wsse:UsernameToken>
   </wsse:Security>
   </soapenv:Header>
   <soapenv:Body>
      <myg:ImportSinglePaymentOrdersRequestIo>
        <myg:singlePaymentOrder xsi:type="myg:TransferToOtherBankForeignCurrencyPaymentOrderIo">
          <!--optional
           <myg:singlePaymentRequestId>231</myg:singlePaymentRequestId>
						-->
            <myg:creditAccount>
               <myg:accountNumber>CZ6508000000192000145399</myg:accountNumber>
            </myg:creditAccount>
            <myg:debitAccount>
               <myg:accountNumber>GE82TB7044436180100003</myg:accountNumber>
               <myg:accountCurrencyCode>USD</myg:accountCurrencyCode>
            </myg:debitAccount>
            <myg:documentNumber>200004</myg:documentNumber>
            <myg:amount>
               <myg:amount>2</myg:amount>
               <myg:currency>USD</myg:currency>
            </myg:amount>
            <myg:position>5</myg:position>
            <myg:additionalDescription></myg:additionalDescription>
            <myg:description>TRANSFER TO OTHER BANK IN FC</myg:description>
            <myg:beneficiaryName>Lorentzen & Sievers GmbH</myg:beneficiaryName>
            <myg:beneficiaryAddress>COUNTRY</myg:beneficiaryAddress>
            <myg:beneficiaryBankCode>MYBANKCODE</myg:beneficiaryBankCode>
            <myg:beneficiaryBankName>MY SPECIAL BANK NAME</myg:beneficiaryBankName>
            <myg:intermediaryBankCode>BDLEIT21300</myg:intermediaryBankCode>
            <myg:intermediaryBankName></myg:intermediaryBankName>
            <myg:chargeDetails>SHA</myg:chargeDetails>
         </myg:singlePaymentOrder>
         </myg:ImportSinglePaymentOrdersRequestIo>	  
   </soapenv:Body>
</soapenv:Envelope>

Treasury Transfer

TreasuryTransferPaymentOrderIo type is described here.

Treasury transfer payment order specifics:

  • creditAccount element must not be used. Instead of this element bank system for treasury
    transfers uses code specified in the treasuryCode element;
  • description element must not be used. It is set automatically by bank system based on the
    treasuryCode element. If description is filled this will cause an error;
  • If either the taxpayerCode or the taxpayerName element is filled then the other is mandatory
    as well. These two elements should not be used when payment is not for other person or
    company.
AttributeTypeComment
taxpayerCodeString
11n		Tax payer identification code of person or company, for which
client makes treasury transfer (mandatory when taxpayerName is filled; if this
attribute is filled this means that payment is for other person or company)
taxpayerNameString
100R		Name of person or company, for which client makes treasury transfer mandatory when
taxpayerCode is filled; if this attribute is filled this means that payment is for other
person or company)
treasuryCodeString
9!n		Tax payment treasury code

Example 5: Import Single Payment Orders Treasury Transfer

<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" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
   <soapenv:Header>
   <wsse:Security>
    <wsse:UsernameToken>
      <wsse:Username>USERNNAME</wsse:Username>
      <wsse:Password>PASSWORD</wsse:Password>
      <wsse:Nonce>1111</wsse:Nonce>
    </wsse:UsernameToken>
   </wsse:Security>
   </soapenv:Header>
   <soapenv:Body>
      <myg:ImportSinglePaymentOrdersRequestIo>
       <myg:singlePaymentOrder xsi:type="myg:TreasuryTransferPaymentOrderIo">
         <!--optional
           <myg:singlePaymentRequestId>231</myg:singlePaymentRequestId>
						-->
            <myg:debitAccount>
               <myg:accountNumber>GE48TB7044436080100017</myg:accountNumber>
               <myg:accountCurrencyCode>GEL</myg:accountCurrencyCode>
            </myg:debitAccount>
            <myg:documentNumber>200005</myg:documentNumber>
            <myg:amount>
               <myg:amount>2</myg:amount>
               <myg:currency>GEL</myg:currency>
            </myg:amount>
            <myg:position>6</myg:position>
            <myg:additionalDescription>Treasury Transfer Example</myg:additionalDescription>
            <myg:treasuryCode>101001000</myg:treasuryCode>
         </myg:singlePaymentOrder>
         </myg:ImportSinglePaymentOrdersRequestIo>	  
   </soapenv:Body>
</soapenv:Envelope>

Single Payment including different order types

Example 6: Valid Message For Different Payment Order Types In Single Payments 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"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
	<soapenv:Header>
		<wsse:Security>
			<wsse:UsernameToken>
				<wsse:Username>USERNAME</wsse:Username>
				<wsse:Password>PASSWORD</wsse:Password>
				<wsse:Nonce>1111</wsse:Nonce>
			</wsse:UsernameToken>
		</wsse:Security>
	</soapenv:Header>
	<soapenv:Body>
		<myg:ImportSinglePaymentOrdersRequestIo>
			<myg:singlePaymentOrder xsi:type="myg:TransferToOwnAccountPaymentOrderIo">
        <!--optional
           <myg:singlePaymentRequestId>231</myg:singlePaymentRequestId>
						-->
				<myg:creditAccount>
					<myg:accountNumber>GE82TB7044436180100003</myg:accountNumber>
					<myg:accountCurrencyCode>USD</myg:accountCurrencyCode>
				</myg:creditAccount>
				<myg:debitAccount>
					<myg:accountNumber>GE48TB7044436080100017</myg:accountNumber>
					<myg:accountCurrencyCode>GEL</myg:accountCurrencyCode>
				</myg:debitAccount>
				<myg:documentNumber>200000</myg:documentNumber>
				<myg:amount>
					<myg:amount>2</myg:amount>
					<myg:currency>GEL</myg:currency>
				</myg:amount>
				<myg:position>1</myg:position>
				<myg:description>Transfer to Own Account</myg:description>
			</myg:singlePaymentOrder>
			<myg:singlePaymentOrder xsi:type="myg:TransferToOwnAccountPaymentOrderIo">
        <!--optional
           <myg:singlePaymentRequestId>231</myg:singlePaymentRequestId>
						-->
				<myg:creditAccount>
					<myg:accountNumber>GE82TB7044436180100003</myg:accountNumber>
					<myg:accountCurrencyCode>USD</myg:accountCurrencyCode>
				</myg:creditAccount>
				<myg:debitAccount>
					<myg:accountNumber>GE48TB7044436080100017</myg:accountNumber>
					<myg:accountCurrencyCode>GEL</myg:accountCurrencyCode>
				</myg:debitAccount>
				<myg:documentNumber>200001</myg:documentNumber>
				<myg:amount>
					<myg:amount>2</myg:amount>
					<myg:currency>USD</myg:currency>
				</myg:amount>
				<myg:position>2</myg:position>
				<myg:description>Currency Exchange</myg:description>
			</myg:singlePaymentOrder>
			<myg:singlePaymentOrder xsi:type="myg:TransferWithinBankPaymentOrderIo">
        <!--optional
           <myg:singlePaymentRequestId>231</myg:singlePaymentRequestId>
						-->
				<myg:creditAccount>
					<myg:accountNumber>GE88TB0600000003718633</myg:accountNumber>
				</myg:creditAccount>
				<myg:debitAccount>
					<myg:accountNumber>GE48TB7044436080100017</myg:accountNumber>
					<myg:accountCurrencyCode>GEL</myg:accountCurrencyCode>
				</myg:debitAccount>
				<myg:documentNumber>200002</myg:documentNumber>
				<myg:amount>
					<myg:amount>2</myg:amount>
					<myg:currency>GEL</myg:currency>
				</myg:amount>
				<myg:position>3</myg:position>
				<myg:additionalDescription>Transfer within TBC Bank Example</myg:additionalDescription>
				<myg:description>Transfer within TBC Bank</myg:description>
				<myg:beneficiaryName>Some Company Ltd</myg:beneficiaryName>
			</myg:singlePaymentOrder>
			<myg:singlePaymentOrder xsi:type="myg:TransferToOtherBankNationalCurrencyPaymentOrderIo">
        <!--optional
           <myg:singlePaymentRequestId>231</myg:singlePaymentRequestId>
						-->
				<myg:creditAccount>
					<myg:accountNumber>GE33BG0000000263255500</myg:accountNumber>
				</myg:creditAccount>
				<myg:debitAccount>
					<myg:accountNumber>GE48TB7044436080100017</myg:accountNumber>
					<myg:accountCurrencyCode>GEL</myg:accountCurrencyCode>
				</myg:debitAccount>
				<myg:documentNumber>200003</myg:documentNumber>
				<myg:amount>
					<myg:amount>2</myg:amount>
					<myg:currency>GEL</myg:currency>
				</myg:amount>
				<myg:position>4</myg:position>
				<myg:additionalDescription>Transfer to Other Bank in NC Example</myg:additionalDescription>
				<myg:description>Transfer to Other Bank in National Currency</myg:description>
				<myg:beneficiaryName>Some Company Ltd</myg:beneficiaryName>
				<myg:beneficiaryTaxCode>100200300</myg:beneficiaryTaxCode>
			</myg:singlePaymentOrder>
			<myg:singlePaymentOrder xsi:type="myg:TransferToOtherBankForeignCurrencyPaymentOrderIo">
        <!--optional
           <myg:singlePaymentRequestId>231</myg:singlePaymentRequestId>
						-->
				<myg:creditAccount>
					<myg:accountNumber>CZ6508000000192000145399</myg:accountNumber>
				</myg:creditAccount>
				<myg:debitAccount>
					<myg:accountNumber>GE82TB7044436180100003</myg:accountNumber>
					<myg:accountCurrencyCode>USD</myg:accountCurrencyCode>
				</myg:debitAccount>
				<myg:documentNumber>200004</myg:documentNumber>
				<myg:amount>
					<myg:amount>2</myg:amount>
					<myg:currency>USD</myg:currency>
				</myg:amount>
				<myg:position>5</myg:position>
				<myg:additionalDescription>EXAMPLE</myg:additionalDescription>
				<myg:description>TRANSFER TO OTHER BANK IN FOREIGN CURRENCY</myg:description>
				<myg:beneficiaryName>SOME COMPANY LTD</myg:beneficiaryName>
				<myg:beneficiaryAddress>COUNTRY</myg:beneficiaryAddress>
				<myg:beneficiaryBankCode>MYBANKCODE</myg:beneficiaryBankCode>
				<myg:beneficiaryBankName>MY SPECIAL BANK NAME</myg:beneficiaryBankName>
				<myg:intermediaryBankCode>BDLEIT21300</myg:intermediaryBankCode>
				<myg:intermediaryBankName></myg:intermediaryBankName>
				<myg:chargeDetails>SHA</myg:chargeDetails>
			</myg:singlePaymentOrder>
			<myg:singlePaymentOrder xsi:type="myg:TreasuryTransferPaymentOrderIo">
        <!--optional
           <myg:singlePaymentRequestId>231</myg:singlePaymentRequestId>
						-->
				<myg:debitAccount>
					<myg:accountNumber>GE48TB7044436080100017</myg:accountNumber>
					<myg:accountCurrencyCode>GEL</myg:accountCurrencyCode>
				</myg:debitAccount>
				<myg:documentNumber>200005</myg:documentNumber>
				<myg:amount>
					<myg:amount>2</myg:amount>
					<myg:currency>GEL</myg:currency>
				</myg:amount>
				<myg:position>6</myg:position>
				<myg:additionalDescription>Treasury Transfer Example</myg:additionalDescription>
				<myg:treasuryCode>100071003</myg:treasuryCode>
			</myg:singlePaymentOrder>
			<myg:singlePaymentOrder xsi:type="myg:TreasuryTransferPaymentOrderIo">
        <!--optional
           <myg:singlePaymentRequestId>231</myg:singlePaymentRequestId>
						-->
				<myg:debitAccount>
					<myg:accountNumber>GE48TB7044436080100017</myg:accountNumber>
					<myg:accountCurrencyCode>GEL</myg:accountCurrencyCode>
				</myg:debitAccount>
				<myg:documentNumber>200006</myg:documentNumber>
				<myg:amount>
					<myg:amount>2</myg:amount>
					<myg:currency>GEL</myg:currency>
				</myg:amount>
				<myg:position>7</myg:position>
				<myg:additionalDescription>Treasury Transfer for other Example</myg:additionalDescription>
				<myg:taxpayerCode>100200300</myg:taxpayerCode>
				<myg:taxpayerName>Other Company Ltd</myg:taxpayerName>
				<myg:treasuryCode>100071003</myg:treasuryCode>
			</myg:singlePaymentOrder>
		</myg:ImportSinglePaymentOrdersRequestIo>
	</soapenv:Body>
</soapenv:Envelope>

List Of Response Attributes In ImportSinglePaymentOrders Web Service

Attribute
positionIntegerPosition copied from request message of given single payment order.
Serves for matching which PaymentId belongs to wich payment order in request.
PaymentIdStringPayment order ID assigned by Bank's digital channel (Internet/Mobile banking; DBI integration service)

👍

Example 7: Success Response For Different Payment Order Types In Single Payments Import

<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:ImportSinglePaymentOrdersResponseIo
			xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
			xmlns:xsd="http://www.w3.org/2001/XMLSchema">
			<ns2:PaymentOrdersResults>
				<ns2:position>1</ns2:position>
				<ns2:paymentId>541350990</ns2:paymentId>
			</ns2:PaymentOrdersResults>
			<ns2:PaymentOrdersResults>
				<ns2:position>2</ns2:position>
				<ns2:paymentId>541350991</ns2:paymentId>
			</ns2:PaymentOrdersResults>
			<ns2:PaymentOrdersResults>
				<ns2:position>3</ns2:position>
				<ns2:paymentId>541350992</ns2:paymentId>
			</ns2:PaymentOrdersResults>
			<ns2:PaymentOrdersResults>
				<ns2:position>4</ns2:position>
				<ns2:paymentId>541350993</ns2:paymentId>
			</ns2:PaymentOrdersResults>
			<ns2:PaymentOrdersResults>
				<ns2:position>5</ns2:position>
				<ns2:paymentId>541350994</ns2:paymentId>
			</ns2:PaymentOrdersResults>
			<ns2:PaymentOrdersResults>
				<ns2:position>6</ns2:position>
				<ns2:paymentId>541350995</ns2:paymentId>
			</ns2:PaymentOrdersResults>
			<ns2:PaymentOrdersResults>
				<ns2:position>7</ns2:position>
				<ns2:paymentId>541350996</ns2:paymentId>
			</ns2:PaymentOrdersResults>
		</ns2:ImportSinglePaymentOrdersResponseIo>
	</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

❗️

Example 8: If More Than 10 Single Payment Orders Of Different Types Are Imported

<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:INCORRECT_INPUT_DATA
			</faultcode>
			<faultstring xml:lang="en">Maximum allowed number of single payment orders in 1 request is 10</faultstring>
		</s:Fault>
	</s:Body>
</s:Envelope>

👍

Example 9: Success Response For Any Types In Single Payments Import

<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:ImportSinglePaymentOrdersResponseIo
			xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
			xmlns:xsd="http://www.w3.org/2001/XMLSchema">
			<ns2:PaymentOrdersResults>
				<ns2:position>1</ns2:position>
				<ns2:paymentId>541352002</ns2:paymentId>
			</ns2:PaymentOrdersResults>
		</ns2:ImportSinglePaymentOrdersResponseIo>
	</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Common Errors

❗️

Example 10: Error When There Is Already Imported Single Payment Order With The Same Request ID

<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:DUPLICATED_SINGLE_PAYMENT_REQUEST
			</faultcode>
			<faultstring xml:lang="en">There is already imported single payment order with the same request ID ('231') for the same client.</faultstring>
		</s:Fault>
	</s:Body>
</s:Envelope>

❗️

Example 11: Error When ChargeDerails Value Is Invalid

<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:GENERAL_ERROR
			</faultcode>
			<faultstring xml:lang="en">No catalog object found for code AAA in catalog cz.bsc.g6.components.payment.domain.catalog.FeePaymentMethod</faultstring>
		</s:Fault>
	</s:Body>
</s:Envelope>

❗️

Example 12: Error When Position Value Is Duplicated

<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:INCORRECT_INPUT_DATA
			</faultcode>
			<faultstring xml:lang="en">Position element is not unique. Duplicate position value = 1</faultstring>
		</s:Fault>
	</s:Body>
</s:Envelope>

Updated 11 months ago