Insert Bank Details Capture generated template
If you use our Bank Details Capture service to return you the paymentTemplate XML, you can insert this XML into your <payToBankAccountV3>
request.
This shows an example paymentTemplate that can be returned to you in an XML format:
<paymentTemplate Name="United Kingdom" TransferTypeDesc="Local Payment" TemplateID="ea189719ecdae011a6740026b9792fb4" TemplateType="1" TemplateCountry="GB" TemplateCurrency="GBP" TemplateLanguage="en"> <Row Id="BankName" Value="HSBC" /> <Row Id="BranchAddress" Value="London" /> <Row Id="CustomerName" Value="John Smith" /> <Row Id="BankAccountNumber" Value="12345678" /> <Row Id="BankCode" Value="112233"></Row> </paymentTemplate>
This XML shows how the above paymentTemplate should be inserted into a <payToBankAccountV3>
request:
<?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<soap:Body>
<payToBankAccountV3 xmlns="http://merchantapi.envoyservices.com">
<auth>
<username>amerchant25</username>
<password>s23dLjdf</password>
</auth>
<requestReference>2450924358743589381</requestReference>
<paymentInstructions>
<paymentInstructionV3>
<paymentDetails>
<countryCode>GB</countryCode>
<sourceCurrency>GBP</sourceCurrency>
<targetCurrency>EUR</targetCurrency>
<targetAmount>200.00</targetAmount>
<sourceOrTarget>T</sourceOrTarget>
<merchantReference>lecompte205</merchantReference>
<paymentReference>2340983560894390</paymentReference>
</paymentDetails>
<paymentTemplate Name="United Kingdom" TransferTypeDesc="Local Payment" TemplateID="ea189719ecdae011a6740026b9792fb4" TemplateType="1" TemplateCountry="GB" TemplateCurrency="GBP" TemplateLanguage="en">
<Row Id="BankName" Value="HSBC" />
<Row Id="BranchAddress" Value="London" />
<Row Id="CustomerName" Value="John Smith" />
<Row Id="BankAccountNumber" Value="12345678" />
<Row Id="BankCode" Value="112233" />
</paymentTemplate>
</paymentInstructionV3>
</paymentInstructions>
</payToBankAccountV3>
</soap:Body>
</soap:Envelope>
When you submit a “select” type Row (for example Beneficiary Country) you can only submit the selected value. If you submit unselected values, the system rejects the request.