GetBankTransferOptions (V6)

Description

The GetBankTransferOptions request will be used for requesting a payment using Bank Transfer, API will accept a CompanyToken and TransactionToken.

Instructions for the payment process will then be returned, this should be displayed to the customer.
Upon the customer payment, the transaction status would be updated and should be checked in “verifyToken”
URL: https://secure.3gdirectpay.com/API/v6/

Response

The method will return payment instructions of all available bank transfer options.

Variables to send:

Parameter	Data type	Description
Request	Text	GetBankTransferOptions	Mandatory
CompanyToken	Token	Token you got from 3G to operate this API	Mandatory
TransactionToken	Token	Transaction token as accepted from the createToken.	Mandatory

Request example:

request example

<?xml version="1.0" encoding="UTF-8"?>
<API3G>
   <CompanyToken>68B90B5E-25F6-4146-8AB1-C7A3A0C41A7F</CompanyToken>
   <Request>GetBankTransferOptions</Request>
   <TransactionToken>9EF83250-B6A2-4FDD-A290-C4CE7EA6D447</TransactionToken>
</API3G>

Respond:

The server will respond for the ChargeTokenMobile request according to the following results:

Parameter	Data type	Description
Result	3 digits code	A code will be sent with the result of the request
ResultExplanation	Text	Free text of the result
option → bankName	Text	Bank name
option → bankCode	Text	Bank code
option → instructions	Text	Bank instructions, per language
option → instructions → bankInstructionsEN	Text	English instructions. ";" means brake line
option → instructions → bankInstructionsIT	Text	Italian instructions. ";" means brake line
option → instructions → bankInstructionsFR	Text	French instructions. ";" means brake line
option → instructions → bankInstructionsSW	Text	Swahili instructions. ";" means brake line

Respond codes:

Code	Explanation
000	Success
999	Custom error message
804	Error in XML
950	Request missing transaction level mandatory fields

Respond example:

response example

<?xml version="1.0" encoding="utf-8"?>
<API3G>
    <Result>000</Result>
    <ResultExplanation>Success</ResultExplanation>
    <bankOptions>
        <option>
            <bankName>DTB Kenya USD</bankName>
            <bankCode>DTB</bankCode>
            <instructions>
                <bankInstructionsEN>Please use the below details for your bank transfer;Account Name : '3G Direct Pay Limited';Bank Name : Diamond Trust Bank;Branch : Tom Mboya;Bank Address : 'MondLane/Tom Mboya, Nairobi, Kenya';Account Number : 0002725005;SWIFT CODE : DTKEKENA ; Please add the following text within your transaction (additional information field): 654597 ;</bankInstructionsEN>
                <bankInstructionsIT>Usa i dettagli sottostanti per il tuo trasferimento bancario;Nome del Conto : '3G Direct Pay Limited';Nome della Banca : Diamond Trust Bank;Filiale : Tom Mboya;Indirizzo della Banca : 'MondLane/Tom Mboya, Nairobi, Kenya';Numero del Conto : 0002725005;CODICE SWIFT : DTKEKENA ; Aggiungi il seguente testo nella tua transazione (campo ulteriori informazioni) 654597 ;</bankInstructionsIT>
                <bankInstructionsFR>Veuillez utiliser les d and eacutetails ci-dessous pour votre virement bancaire;Nom du compte : '3G Direct Pay Limited';Nom de la banque : Diamond Trust Bank;Agence : Tom Mboya;Adresse de la banque : 'MondLane/Tom Mboya, Nairobi, Kenya';Num and eacutero de compte : 0002725005;CODE SWIFT : DTKEKENA ; Veuillez ajouter le texte suivant dans votre transaction (champ des informations supplémentaires) 654597 ;</bankInstructionsFR>
                <bankInstructionsSW>Tafadhali tumia maelezo yaliyo chini kwa ajili ya uhamishaji wa benki;Jina la Akaunti : '3G Direct Pay Limited';Jina la Benki : Diamond Trust Bank;Tawi : Tom Mboya;Anwani ya Benki : 'MondLane/Tom Mboya, Nairobi, Kenya';Namba ya Akaunti : 0002725005;SWIFT CODE : DTKEKENA ; Tafadhali ongeza maandishi yafuatayo katika mapatano (eneo la maelezo zaidi) 654597 ;</bankInstructionsSW>
            </instructions>
        </option>
        <option>
            <bankName>DTB Kenya KES</bankName>
            <bankCode>DTBKE</bankCode>
            <instructions>
                <bankInstructionsEN>Please use the below details for your bank transfer;Account Name : '3G Direct Pay Limited';Bank Name : Diamond Trust Bank;Branch : Tom Mboya;Bank Address : 'MondLane/Tom Mboya, Nairobi, Kenya';Account Number : 0002725004;SWIFT CODE : DTKEKENA ; Please add the following text within your transaction (additional information field): 654597 ;</bankInstructionsEN>
                <bankInstructionsIT>Usa i dettagli sottostanti per il tuo trasferimento bancario;Nome del Conto : '3G Direct Pay Limited';Nome della Banca : Diamond Trust Bank;Filiale : Tom Mboya;Indirizzo della Banca : 'MondLane/Tom Mboya, Nairobi, Kenya';Numero del Conto : 0002725004;CODICE SWIFT : DTKEKENA ; Aggiungi il seguente testo nella tua transazione (campo ulteriori informazioni) 654597 ;</bankInstructionsIT>
                <bankInstructionsFR>Veuillez utiliser les d and eacutetails ci-dessous pour votre virement bancaire;Nom du compte : '3G Direct Pay Limited';Nom de la banque : Diamond Trust Bank;Agence : Tom Mboya;Adresse de la banque : 'MondLane/Tom Mboya, Nairobi, Kenya';Num and eacutero de compte : 0002725004;CODE SWIFT : DTKEKENA ; Veuillez ajouter le texte suivant dans votre transaction (champ des informations supplémentaires) 654597 ;</bankInstructionsFR>
                <bankInstructionsSW>Tafadhali tumia maelezo yaliyo chini kwa ajili ya uhamishaji wa benki;Jina la Akaunti : '3G Direct Pay Limited';Jina la Benki : Diamond Trust Bank;Tawi : Tom Mboya;Anwani ya Benki : 'MondLane/Tom Mboya, Nairobi, Kenya';Namba ya Akaunti : 0002725004;SWIFT CODE : DTKEKENA ; Tafadhali ongeza maandishi yafuatayo katika mapatano (eneo la maelezo zaidi) 654597 ;</bankInstructionsSW>
            </instructions>
        </option>
        <option>
            <bankName>AIB Ireland</bankName>
            <bankCode>AIB</bankCode>
            <instructions>
                <bankInstructionsEN>Please use the below details for your bank transfer;Account Name : '3G Direct Pay Limited';Bank Name : Allied Irish Bank;Bank Address : 140 Lower Drumcondra Road, Drumcondra, Dublin 9;Account Number : 18597896;Sort Code : 93-21-08;SWIFT CODE : AIBKIE2D;IBAN : IE03AIBK93006718597896;SWIFT CODE : AIBKIE2D ; Please add the following text within your transaction (additional information field): 654597 ;</bankInstructionsEN>
                <bankInstructionsIT>Usa i dettagli sottostanti per il tuo trasferimento bancario;Nome del Conto : '3G Direct Pay Limited' ;Nome della Banca : Allied Irish Bank ;Indirizzo della Banca : 140 Lower Drumcondra Road, Drumcondra, Dublino 9 ;Numero del Conto : 18597896 ;Codice Filiale : 93-21-08 ;CODICE SWIFT : AIBKIE2D ;IBAN : IE03AIBK93006718597896 ;CODICE SWIFT : AIBKIE2D ; Aggiungi il seguente testo nella tua transazione (campo ulteriori informazioni) 654597 ;</bankInstructionsIT>
                <bankInstructionsFR>Veuillez utiliser les d and eacutetails ci-dessous pour votre virement bancaire;Nom du compte : '3G Direct Pay Limited' ;Nom de la banque : Allied Irish Bank ;Adresse de la banque : 140 Lower Drumcondra Road, Drumcondra, Dublin 9 ;Num and eacutero de compter : 18597896 ;Code guichet : 93-21-08 ;CODE SWIFT : AIBKIE2D ;IBAN : IE03AIBK93006718597896 ;CODE SWIFT : AIBKIE2D ; Veuillez ajouter le texte suivant dans votre transaction (champ des informations supplémentaires) 654597 ;</bankInstructionsFR>
                <bankInstructionsSW>Tafadhali tumia maelezo yaliyo chini kwa ajili ya uhamishaji wa benki;Jina la Akaunti : '3G Direct Pay Limited' ;Jina la Benki : Allied Irish Bank ;Anwani ya Benki : 140 Lower Drumcondra Road, Drumcondra, Dublin 9 ;Namba ya Akaunti : 18597896 ;Sort Code : 93-21-08 ;SWIFT CODE : AIBKIE2D ;IBAN : IE03AIBK93006718597896 ;SWIFT CODE : AIBKIE2D ; Tafadhali ongeza maandishi yafuatayo katika mapatano (eneo la maelezo zaidi) 654597 ;</bankInstructionsSW>
            </instructions>
        </option>
        <option>
            <bankName>Bank of Ireland</bankName>
            <bankCode>BOI</bankCode>
            <instructions>
                <bankInstructionsEN>Please use the below details for your bank transfer;Account Name : ÐG Direct Pay Limited' ;Bank Name : Bank of Ireland ;Bank Address : 'Lower Baggot St 2 Co. Dublin, City of Dublin' ;SWIFT CODE : BOFIIE2D ;IBAN : IE23BOFI90139474308003 ; Please add the following text within your transaction (additional information field): 654597 ;</bankInstructionsEN>
                <bankInstructionsIT>Usa i dettagli sottostanti per il tuo trasferimento bancario;Nome del Conto : ÐG Direct Pay Limited' ;Nome della Banca : Bank of Ireland ;Indirizzo della Banca : 'Lower Baggot St 2 Co. Dublin, City of Dublin' ;CODICE SWIFT : BOFIIE2D ;IBAN : IE23BOFI90139474308003 ; Aggiungi il seguente testo nella tua transazione (campo ulteriori informazioni) 654597 ;</bankInstructionsIT>
                <bankInstructionsFR>Veuillez utiliser les d and eacutetails ci-dessous pour votre virement bancaire;Nom du compte : ÐG Direct Pay Limited' ;Nom de la banque : Bank of Ireland ;Adresse de la banque : 'Lower Baggot St 2 Co. Dublin, City of Dublin' ;CODE SWIFT : BOFIIE2D ;IBAN : IE23BOFI90139474308003 ; Veuillez ajouter le texte suivant dans votre transaction (champ des informations supplémentaires) 654597 ;</bankInstructionsFR>
                <bankInstructionsSW>Tafadhali tumia maelezo yaliyo chini kwa ajili ya uhamishaji wa benki;Jina la Akaunti : ÐG Direct Pay Limited' ;Jina la Benki : Bank of Ireland ;Anwani ya Benki : 'Lower Baggot St 2 Co. Dublin, City of Dublin' ;SWIFT CODE : BOFIIE2D ;IBAN : IE23BOFI90139474308003 ; Tafadhali ongeza maandishi yafuatayo katika mapatano (eneo la maelezo zaidi) 654597 ;</bankInstructionsSW>
            </instructions>
        </option>
    </bankOptions>
</API3G>