View Categories

Volopa Payments File Upload Guide

10 min read

1.  Downloading Your File Template #

Location: Payments >> Batch Payments >> File Upload

What you need to do:

  1. Select Currency: This will prepare a template containing all your existing recipients who have a bank account in this currency
  2. Download payments file: This will generate a CSV file

2. About Your File Template #

  1. Your file template must be in CSV format
  2. You must not add or delete any columns from the file template
  3. Please ensure that there are no empty rows between payments
    1. For example, if a file consists of 10 payments, then rows 2 to 11 should be populated
  4. Please ensure all mandatory fields are accurately filled out
    1. Refer to the File Template Content for the list of mandatory fields
  5. Each row on the file template represents a payment. The default setting assumes one payment per recipient. If you wish to:
    1. Not make a payment to a particular Recipient, then simply delete the row
    1. Make multiple payments to a particular Recipient, then simply replicate the same row

3. File Template Content #

Your file is structured as follows

Field & DatatypeDescriptionUser Input Permitted?Mandatory?Permitted Data
recipient_id NumericalThis is Volopa’s unique identifier of the RecipientNo – This is prepopulatedYesThe Recipient ID must correspond to an existing Recipient on your Volopa account
client_payee_id StringThis is your unique identifier of the Recipient when the Recipient was initially added. You can use this identifier to reconcile payments to this Recipient in your ERP/Accounting SystemNo – This is prepopulated (if already provided when the Recipient was initially added)NoData entered in this field will be ignored. Please contact your Account Manager or the Volopa Customer Support Team should you want to add the Client Payee ID for any existing Recipients
recipient_type StringThis identifies whether the Recipient is an Individual or a BusinessNo – This is prepopulatedYes“Individual” or “Business”
recipient_bank_ country StringThis is the bank account country of the RecipientNo – This is prepopulatedYes3-letter country ISO codes
recipient_account currency StringThis is the currency of Recipient accountNo – This is prepopulatedYes3-letter currency ISO codes. Please note that all entries in the file will have the same Recipient Account Currency
available_settlement_methods StringThese are the settlement methods available to pay this RecipientNo – This is prepopulatedYes“Regular”: If the Regular settlement method is available & selected, Volopa will route the payment through local payment rails, such as ACH, SEPA, and FPS “Priority”: If the Priority settlement method is available & selected, Volopa will route the payment through SWIFT rails
recipient_email _address StringThis is the email address of the Recipient. This would have been added when the Recipient was first added. Volopa will notify this email address whenever a payment to this Recipient is sentNo – This is prepopulatedNoData entered in this field will be ignored. Please contact your Account Manager or the Volopa Customer Support Team should you want to add the Recipient Email Address for any existing Recipients
cc_email_address StringThis is the secondary email address provided for this Recipient. Volopa will notify this email address whenever a payment to this Recipient is sentYes – users can enter values into this fieldNoValid email address format (i.e. contains the @ symbol)
payment_amount Numerical; DecimalThis is the payment amount in the Recipient Account Currency (i.e. this is the amount your Recipient will receive)Yes – users can enter values into this fieldYesNumbers with or without decimals. Must be grater than 0.   For INR Payments, the following limits apply: 1. INR 1,500,000 per Recipient per day   2. INR 1,500,000 limit per invoice
settlement_method StringThis identifies the method through which Volopa will settle this paymentYes – users can enter values into this fieldYes“Regular”: If the Regular settlement method is available & selected, Volopa will route the payment through local payment rails, such as ACH, SEPA, and FPS “Priority”: If the Priority settlement method is available & selected, Volopa will route the payment through SWIFT rails
payment_reason* StringThis is the reason for the payment. It is pre-filled based on the reason selected when the Recipient was first added.   Please note that for the below specific payments corridors, only specific payment reasons are permitted:   1. CNY to China 2. INR to India 3. Payments to the UAE 4. Payments to Bahrain    Yes – users can enter values into this field   Note that while a reason is pre-filled, it can be changed to any of the permitted valuesYes“Payment of Invoice(s)” “Internal Payment to Company own Account” “Payment of Expenses” “Payment of Salaries” “Payment of Commissions” “Payment of Dividends” “Director/Employee loan” “Other”   Please note that for the below specific payments corridors, only specific payment reasons are permitted:   1. CNY to China 2. INR to India 3. Payments to the UAE 4. Payments to Bahrain  
payment_reference StringThis is the reference which will be sent with the payment to the RecipientYes – users can enter values into this field  Yes1-255 alphanumeric characters.   Please note that depending on the Recipient Bank Country and Settlement Method, some payment schemes will truncate the payment reference. For example, Faster Payments will truncate the Reference to 18 characters and ACH will truncate the Reference to 10 characters
purpose_of_payment_code* StringApplicable to the following corridors only: 1. CNY to China 2. INR to India 3. Payments to the UAE 4. Payments to Bahrain   This is the Payment Purpose Code required for the above payments corridors. It is pre-filled based on the payment reason selected when the Recipient was first addedYes – users can enter values into this field   Note that while a Purpose Code is pre-filled, it can be changed to any of the permitted valuesYes (for the specified corridors)The Payment Purpose Codes are only required in some payment corridors:   1. CNY to China 2. INR to India 3. Payments to the UAE 4. Payments to Bahrain  
invoice_number StringOnly required for trade related INR payments to IndiaYes – users can enter values into this fieldYes (for the specified corridors)Invoice Number is required when the Purpose of Payment is trade related
invoice_date StringOnly required for trade related INR payments to IndiaYes – users can enter values into this fieldYes (for the specified corridors)Invoice Date is required when the Purpose of Payment is trade related
incorporation_number StringMandatory for “Regular” TRY payments to Turkey, if the Recipient is a BusinessYes – users can enter values into this fieldYes (for the specified corridors)incorporation_number’ for beneficiaries that are companies. 

* Please refer to the Permitted Special Payment Purpose Codes for the list of permitted purpose codes per payment corridor

4. Special Payment Purpose Codes #

CNY to China #

CodeDescription
CTFCross-border capital transfer
GODCross-border goods trade
STRCross-border service transfer
RMTCross-border individual remittance
OTFOther transfers

INR to India #

CodeDescriptionB2BB2CTrade Related
advertisingAdvertising and public relations-related expenses
advisor_feesFees for advisory, technical, academic or specialist assistance
constructionConstruction costs/expenses
educationEducation-related student expenses
exportsPayments for exported goods
familyFamily maintenance
fund_investmentMutual fund investment
goodsTrade settlement for goods and general goods trades
hotelHotel accommodation
insurance_claimsInsurance claims payment
insurance_premiumInsurance premium
loan_repaymentRepayment of loans
medicalMedical treatment and expenses
other_feesBroker, front end, commitment, guarantee and custodian fees
property_purchasePurchase of residential property
property_rentalPayment of Property Rental
royaltiesRoyalty, trademark, patent and copyright fees
servicesInformation service charges
taxTax payment
transferTransfer to own account
travelTravel
utilitiesUtility bills

Due to circumstances outside our control with one of our banking providers, we’re no longer able to support local INR payments to any beneficiary bank using the below purpose codes: 

  • Salary 
  • Product indemnity insurance
  • Investment in Shares

We are also temporarily unable to support local INR payments in the two cases below from the 5th of March, 2024:

  • Trade-related local INR payments to a HDFC beneficiary bank using any of our supported purpose codes above.
  • Local INR payments to any beneficiary bank using the purpose code ‘delivery – delivery fees for goods’.

Any payments made that meet the above criteria will be rejected. 

Payments to the United Arab Emirates (Any currency): #

CodeDescription
ACMAgency Commission
AESAdvance payment against EOS
AFAReceipts or payments from personal residents bank account or deposits abroad
AFLReceipts or payments from personal non-resident bank account in the UAE
ALWAllowances
ATSAir transport
BONBonus
CCPCorporate Card Payment
CEAEquity and investment fund shares for the establishment of new company from residents abroad, equity of merger or acquisition of companies abroad from residents and participation to capital increase of related companies abroad
CELEquity and investment fund shares for the establishment of new company in the UAE from non-residents, equity of merger or acquisition of companies in the UAE from non-residents and participation to capital increase of related companies from non-residents in the UAE
CHCCharitable Contributions
CINCommercial Investments
COMCommission
COPCompensation
CRPCredit Card Payments
DCPPre-Paid Reloadable & Personalized Debit Card Payments
DIVDividend Payouts
DLAPurchases and sales of foreign debt securities in not related companies – More than a year
DLFDebt instruments intragroup loans, deposits foreign
DLLPurchases and sales of securities issued by residents in not related companies – More than a year
DOEDividends on equity not intra group
DSAPurchases and sales of foreign debt securities in not related companies – Less than a year
DSFDebt instruments intragroup foreign securities
DSLPurchases and sales of securities issued by residents in not related companies – Less than a year
EDUEducational Support
EMIEquated Monthly Instalments
EOSEnd of Service
FAMFamily Support
FDAFinancial derivatives foreign
FDLFinancial derivatives in the UAE
FIAInvestment fund shares foreign
FILInvestment fund shares in the UAE
FISFinancial services
FSAEquity other than investment fund shares in not related companies abroad
FSLEquity other than investment fund shares in not related companies in the UAE
GDEGoods Sold
GDIGoods bought
GMSProcessing repair and maintenance services on goods
GOSGovernment goods and services embassies etc
GRIGovernment related income taxes tariffs capital transfers etc
IFSInformation services
IGDIntra group dividends
IGTInter group transfer
IIDIntra group interest on debt
INSInsurance services
IODIncome on deposits
IOLIncome on loans
IPCCharges for the use of intellectual property royalties
IPOIPO subscriptions
IRPInterest rate swap payments
IRWInterest rate unwind payments
ISHIncome on investment funds share
ISLInterest on securities more than a year
ISSInterest on securities less than a year
ITSComputer services
LASLeave salary
LDLDebt instruments intragroup loans, deposits in the UAE
LDSDebt instruments intragroup securities in the UAE
LEALeasing abroad
LELLeasing in the UAE
LIPLoan interest payments
LLALoans – Drawings or Repayments on loans extended to nonresidents – Long-term
LLLLoans – Drawings or Repayments on foreign loans extended to residents – Long-term
LNCLoan charges
LNDLoan disbursements
MCRMonetary Claim Reimbursements Medical Insurance or Auto Insurance etc.
MWIMobile wallet cash in
MWOMobile wallet cash out
MWPMobile wallet payments
OATOwn account transfer
OTSOther modes of transport
OVTOvertime
PENPension
PINPersonal Investments
PIPProfits on Islamic products
PMSProfessional and management consulting services
PORRefunds or Reversals on IPO subscriptions
POSPOS Merchant Settlement
PPAPurchase of real estate abroad from residents
PPLPurchase of real estate in the UAE from non-residents
PRPProfit rate swap payments
PRRProfits or rents on real estate
PRSPersonal cultural audio visual and recreational services
PRWProfit rate unwind payments
RDSResearch and development services
RFSRepos on foreign securities
RLSRepos on securities issued by residents
RNTRent payments
SAASalary advance
SALSalary
SCOConstruction
SLALoans – Drawings or Repayments on loans extended to nonresidents – Short-term
SLLLoans – Drawings or Repayments on foreign loans extended to residents – Short-term
STRTravel
STSSea transport
SVIStored value card cash-in
SVOStored value card cash-out
SVPStored value card payments
TCPTrade credits and advances payable
TCRTrade credits and advances receivable
TCSTelecommunication services
TKTTickets
TOFTransfer of funds between persons Normal and Juridical
TTSTechnical trade-related and other business services
UTLUtility Bill Payments

Payments to Bahrain (Any currency): #

CodeDescription
GDEGoods sold (Exports in fob value)
GDIGoods bought (Imports in cif value)
STSSea Transport
ATSAir transport
OTSOTS Other methods of transport (including Postal and courier services)
STRTravel
GMSProcessing repair and maintenance services on goods
SCOConstruction
INSInsurance Services
FISFinancial Services
IPCCharges for the use of intellectual property royalties
TCSTelecommunications services
ITSComputer services
IFSInformation services
RDSResearch and development services
PMSProfessional and management consulting services
TTSTechnical, trade- related and other business services
PRSPersonal, cultural, audiovisual and recreational services
IGDDividends intragroup
IIDInterest on debt intragroup
PIPProfits on Islamic products
PRRProfits or rents on real estate
DOEDividends on equity not Intragroup
ISHIncome on investment funds shares
ISLInterest on securities more than a year
ISSInterest on securities less than a year
IOLIncome on loans
IODIncome on deposits
GOSGovernment goods and services embassies etc
GRIGovernment related income taxes, tariffs, capital transfers, etc
CHCCharitable Contributions (Charity and Aid)
FAMFamily Support (Workers’ remittances)
SALSalary (Compensation of employees)
PPAPurchase of real estate abroad from residents
PPLPurchase of real estate in Bahrain from non-residents
CEAEquity and Investment fund shares for the establishment of new company from residents abroad, equity of merger or acquisition of companies

Leave a Reply

Your email address will not be published. Required fields are marked *

Full list of features

Cards Business Account

Card Features

  • Multicurrency Company Wallet – Hold up to 14 major currencies
  • Unlimited Volopa multicurrency business cards for your employees*
  • Wholesale currency conversion rates
  • Free replacement cards
  • Free Company Wallet top ups
  • ATM withdrawals
  • Real-time cards controls
  • Customisable platform user roles & permissions
  • One of the highest spend limits on prepaid cards
  • *Organisations with large amounts of card users may incur an administration fee

Expense Management

  • Full visibility and control in real time over employee cards & spending
  • Extensive expense management tools to categorise transactions
  • Integrate with Xero, QuickBooks or Microsoft Dynamics 365 Business Central
  • Enhanced spending limits & controls for budget management
  • Mobile app for receipt capture, adding notes & categorising transactions
  • Get instant notifications & alerts
  • Download CSV & PDF reports & statements

Business Add-ons

Monthly fee
  • Multicurrency Shared Wallet - £10 / €12
  • Bulk receipts download - £10 / €12
  • Supplier & Invoice Management Portal (coming soon)
  • Advanced Analytics & Reporting (coming soon)

Currency Exchange on Volopa cards

Volopa provides competitive currency exchange fees using our own FX engine

ATM Withdrawal charge 

If you have a GBP card, ATM withdrawals in GBP are charged at 1% of the withdrawal amount with a minimum charge of £2.00. ATM withdrawals in any other currency are charged at £2.00. If you have an EUR card, ATM withdrawals in EUR are charged at 1% of the withdrawal amount with a minimum charge of €2.00. ATM withdrawals in any other currency are charged at €2.00.

Purchase or withdrawal in currency not loaded to card

Mastercard authorised rate plus a fee of 1%

Team Lead - Development

Alex Ceaki

I am a big believer in alignment between people and technology. I lead our close-knit development team to deliver cutting edge features that best suit our clients. After a busy week coordinating deployments, you can find me unwinding on a hike in some hilly fields.