Skip to content

Batch payment file (VND and PHP)

The download template file for currencies VND and PHP contains the fields listed in this topic.

Note:

All fields except for Beneficiary Nickname are required and must be specified.

Beneficiary Nickname

  • Description: Optional nickname for the party to which a payment amount is due.
  • Expected data format: String, up to 64 alphanumeric characters
  • Example: Ben Nick

Beneficiary Name

  • Description: Name of the party to which a payment amount is due.
  • Expected data format: String, up to 140 alphanumeric characters
  • Example: Example Company

Quote Type

  • Description: Specifies how the quote for payment amount will be calculated, either by Sending Amount (before factoring in the FX and cost) or by *Receiving Amount" (after FX and fees have been applied).

  • Possible values:

    • Sending Amount
    • Receiving Amount
  • Example: Receiving Amount

Amount

  • Description: Based on what's specified in the Quote Type column, specifies the amount to be sent or received.
  • Expected data format: String, value up to 2400000000 VND / 2650000 PHP or equivalent amount in USD per day per beneficiary
  • Example: 250000 PHP

Payment Currency

  • Description: Currency of the amount that's sent or received.

  • Possible values:

    • USD -- US Dollar (Sending Amount only)
    • VND -- Vietnamese Dong (Receiving Amount only)
    • PHP -- Philippine Peso (Receiving Amount only)
  • Example: VND

Payout Currency

  • Description: Currency of the beneficiary's account.

  • Possible values:

    • VND -- Vietnamese Dong
    • PHP -- Philippine Peso
  • Example: VND

Purpose of Transaction

  • Description: Purpose code of the payment transaction.

  • Possible values:

    Click to expand
  • DEPT -- Deposit
  • INTC -- Intra company payment
  • GDDS -- Purchase sale of goods
  • GDSV -- Purchase sale of goods and services
  • SCVE -- Purchase sale of services
  • SUPP -- Supplier payment
  • TRAD -- Trade services
  • MP2P -- Mobile peer-to-peer (P2P) payment
  • EDUC -- Education
  • FEES -- Payment of fees
  • IVPT -- Invoice payment
  • STDY -- Study
  • MDCS -- Medical services
  • ALLW -- Allowance
  • BONU -- Bonus payment
  • COMM -- Commission
  • PAYR -- Payroll
  • SALA -- Salary payment
  • FAMI -- Family maintenance
  • GIFT -- Allowance (Gift)
  • OTHR -- Others
  • OCDM -- Order cheque domestic
  • OCFG -- Order cheque foreign
  • MFGD -- Payment for manufactured goods
  • MACH -- Payment for machinery, non-customized packaged software and transport equipment
  • MMFA -- Payment for miscellaneous manufactured articles
  • GSPM -- Goods for processing and manufacturing services
  • PSFR -- Passenger fare
  • MRSC -- Maintenance and repair services
  • GSTR -- Goods and services by travelers
  • GSST -- Goods and services by short-term workers
  • INVS -- Investment and securities
  • INTE -- Interest
  • CISC -- Construction and installation services
  • ENGS -- Architectural, engineering and other technical services
  • HLTC -- Home health care
  • EDSC -- Education services
  • TLLT -- Term loans long-term
  • TLST -- Term loans short-term
  • RELG -- Rental lease general
  • DOFI -- Deposits with or from offshore financial institutions
  • VIAC -- Visa application charges
  • REAB -- Real estate abroad
  • Example: SALA

Beneficiary Identification

  • Description: Identification of the beneficiary organization, assigned by an institution.
  • Expected data format: Any string, up to 35 characters
  • Example: C0123456

Beneficiary Identification Scheme

  • Description: Name of the identification scheme used to identify the beneficiary organization.
  • Possible values: CINC -- Certificate of Incorporation Number
  • Example: CINC

Beneficiary Relationship to Sending Customer

  • Description: Relationship of the beneficiary to the sending customer.

  • Possible values:

    • BRAN -- Branch/Representative office
    • CUST -- Customer
    • FRAN -- Franchisee/Franchisor
    • HOLD -- Holding company
    • PART -- Business partner
    • SUBS -- Subsidiary
    • SUPP -- Supplier
  • Example: CUST

Beneficiary Email

  • Description: E-mail of the beneficiary.
  • Expected data format: String
  • Example: example@email.com

Beneficiary Mobile Phone Number

  • Description: Mobile phone number of the beneficiary.
  • Expected data format: String, up to 15 digits (including the + and country code digits)
  • Example: +840912345678

Beneficiary Postal Address

  • Description: Street address of the beneficiary.
  • Expected data format: String, up to 70 alphanumeric characters
  • Example: 160 Thành Công

Beneficiary City

  • Description: City or town of the beneficiary as defined by postal services.
  • Expected data format: Any string
  • Example: Hồ Chí Minh

Beneficiary Nationality

  • Description: Country of residence of the beneficiary using the ISO alpha-2 country code.

  • Possible values:

    Click to expand
    Country name (English)Alpha-2 code
    AfghanistanAF
    AlbaniaAL
    AlgeriaDZ
    American SamoaAS
    AndorraAD
    AngolaAO
    AnguillaAI
    AntarcticaAQ
    Antigua and BarbudaAG
    ArgentinaAR
    ArmeniaAM
    ArubaAW
    AustraliaAU
    AustriaAT
    AzerbaijanAZ
    Bahamas (the)BS
    BahrainBH
    BangladeshBD
    BarbadosBB
    BelarusBY
    BelgiumBE
    BelizeBZ
    BeninBJ
    BermudaBM
    Åland IslandsAX
    BhutanBT
    Bolivia (Plurinational State of)BO
    Bonaire, Sint Eustatius and SabaBQ
    Bosnia and HerzegovinaBA
    BotswanaBW
    Bouvet IslandBV
    BrazilBR
    British Indian Ocean Territory (the)IO
    Brunei DarussalamBN
    BulgariaBG
    Burkina FasoBF
    BurundiBI
    Cabo VerdeCV
    CambodiaKH
    CameroonCM
    CanadaCA
    Cayman Islands (the)KY
    Central African RepublicCF
    ChadTD
    ChileCL
    ChinaCN
    Christmas IslandCX
    Cocos (Keeling) Islands (the)CC
    ColombiaCO
    Comoros (the)KM
    Congo (the Democratic Republic of the)CD
    Congo (the)CG
    Cook Islands (the)CK
    Costa RicaCR
    CroatiaHR
    CubaCU
    CuraçaoCW
    CyprusCY
    CzechiaCZ
    Côte d'IvoireCI
    DenmarkDK
    DjiboutiDJ
    DominicaDM
    Dominican Republic (the)DO
    EcuadorEC
    EgyptEG
    El SalvadorSV
    Equatorial GuineaGQ
    EritreaER
    EstoniaEE
    Falkland Islands (the) [Malvinas]FK
    Faroe Islands (the)FO
    FijiFJ
    FinlandFI
    FranceFR
    French GuianaGF
    French PolynesiaPF
    French Southern Territories (the)TF
    GabonGA
    Gambia (the)GM
    GeorgiaGE
    GermanyDE
    GhanaGH
    GibraltarGI
    GreeceGR
    GreenlandGL
    GrenadaGD
    GuadeloupeGP
    GuamGU
    GuatemalaGT
    GuernseyGG
    GuineaGN
    Guinea-BissauGW
    GuyanaGY
    HaitiHT
    Heard Island and McDonald IslandsHM
    Holy See (the)VA
    HondurasHN
    Hong KongHK
    HungaryHU
    IcelandIS
    IndiaIN
    IndonesiaID
    Iran (Islamic Republic of)IR
    IraqIQ
    IrelandIE
    Isle of ManIM
    IsraelIL
    ItalyIT
    JamaicaJM
    JapanJP
    JerseyJE
    JordanJO
    KazakhstanKZ
    KenyaKE
    KiribatiKI
    Korea (the Democratic People's Republic of)KP
    Korea (the Republic of)KR
    KuwaitKW
    KyrgyzstanKG
    Lao People's Democratic Republic (the)LA
    LatviaLV
    LebanonLB
    LesothoLS
    LiberiaLR
    LibyaLY
    LiechtensteinLI
    LithuaniaLT
    LuxembourgLU
    MacaoMO
    MadagascarMG
    MalawiMW
    MalaysiaMY
    MaldivesMV
    MaliML
    MaltaMT
    Marshall Islands (the)MH
    MartiniqueMQ
    MauritaniaMR
    MauritiusMU
    MayotteYT
    MexicoMX
    Micronesia (Federated States of)FM
    Moldova (the Republic of)MD
    MonacoMC
    MongoliaMN
    MontenegroME
    MontserratMS
    MoroccoMA
    MozambiqueMZ
    MyanmarMM
    NamibiaNA
    NauruNR
    NepalNP
    Netherlands (Kingdom of the)NL
    New CaledoniaNC
    New ZealandNZ
    NicaraguaNI
    Niger (the)NE
    NigeriaNG
    NiueNU
    Norfolk IslandNF
    North MacedoniaMK
    Northern Mariana Islands (the)MP
    NorwayNO
    OmanOM
    PakistanPK
    PalauPW
    Palestine, State ofPS
    PanamaPA
    Papua New GuineaPG
    ParaguayPY
    PeruPE
    Philippines (the)PH
    PitcairnPN
    PolandPL
    PortugalPT
    Puerto RicoPR
    QatarQA
    RomaniaRO
    Russian Federation (the)RU
    RwandaRW
    ReunionRE
    Saint BarthélemyBL
    Saint Helena, Ascension and Tristan da CunhaSH
    Saint Kitts and NevisKN
    Saint LuciaLC
    Saint Martin (French part)MF
    Saint Pierre and MiquelonPM
    Saint Vincent and the GrenadinesVC
    SamoaWS
    San MarinoSM
    Sao Tome and PrincipeST
    Saudi ArabiaSA
    SenegalSN
    SerbiaRS
    SeychellesSC
    Sierra LeoneSL
    SingaporeSG
    Sint Maarten (Dutch part)SX
    SlovakiaSK
    SloveniaSI
    Solomon IslandsSB
    SomaliaSO
    South AfricaZA
    South Georgia and the South Sandwich IslandsGS
    South SudanSS
    SpainES
    Sri LankaLK
    Sudan (the)SD
    SurinameSR
    Svalbard and Jan MayenSJ
    SwedenSE
    SwitzerlandCH
    Syrian Arab Republic (the)SY
    Taiwan (Province of China)TW
    TajikistanTJ
    Tanzania, the United Republic ofTZ
    ThailandTH
    Timor-LesteTL
    TogoTG
    TokelauTK
    TongaTO
    Trinidad and TobagoTT
    TunisiaTN
    TurkmenistanTM
    Turks and Caicos Islands (the)TC
    TuvaluTV
    TürkiyeTR
    UgandaUG
    UkraineUA
    United Arab Emirates (the)AE
    United Kingdom of Great Britain and Northern Ireland (the)GB
    United States Minor Outlying Islands (the)UM
    United States of America (the)US
    UruguayUY
    UzbekistanUZ
    VanuatuVU
    Venezuela (Boliviarian Republic of)VE
    Viet NamVN
    Virgin Islands (British)VG
    Virgin Islands (U.S.)VI
    Wallis and FutunaWF
    Western SaharaEH
    YemenYE
    ZambiaZM
    ZimbabweZW
  • Example: VN

Beneficiary Postal Code

  • Description: Postal code for the postal address of the beneficiary as defined by postal services.
  • Expected data format: String, up to 16 alphanumeric characters
  • Example: 700000

Source of Funds

  • Description: Source where funds for the payment come from.

  • Possible values:

    Click to expand
  • ALMY -- Alimony
  • CASH -- Cash Proceeds
  • COMP -- Compensation
  • EMIN -- Employee Income
  • GIFT -- Gift
  • INHE -- Inheritance
  • INLQ -- Insurance Premium Liquidation
  • PACA -- Paid Up Capital
  • REDM -- Redemption
  • REPY -- Retirement Policy
  • REST -- Real Estate Sale
  • RETA -- Retained Earnings
  • SALE -- Sale of Goods
  • SEAQ -- Sale Acquisition Corporation
  • SELF -- Self Employment Income
  • SVGS -- Savings
  • WINS -- Winnings
  • Example: EMIN

Beneficiary Account Number (non-IBAN)

  • Description: Beneficiary's bank account number in non-IBAN format.
  • Expected data format: String, up to 34 digits
  • Example: 1234567890

Beneficiary Account Identification Scheme

  • Description: Name of the beneficiary account identification scheme as assigned by the account servicer. Mandatory for all bank, wallet, and card payouts.
  • Possible values: BBAN-- Basic Bank Account Number
  • Example: BBAN

Beneficiary Bank Account Agent Identification Scheme

  • Description: Unique identification of an agent as assigned by a financial institution servicing an account for the beneficiary, using an identification scheme.
  • Possible values: See Bank IDs
  • Example: 84001

Beneficiary Bank Branch Country

  • Description: Country of the bank branch of the financial institution servicing the beneficiary account, using the ISO alpha-2 country code.

  • Possible values:

    Click to expand
    Country name (English)Alpha-2 code
    AfghanistanAF
    AlbaniaAL
    AlgeriaDZ
    American SamoaAS
    AndorraAD
    AngolaAO
    AnguillaAI
    AntarcticaAQ
    Antigua and BarbudaAG
    ArgentinaAR
    ArmeniaAM
    ArubaAW
    AustraliaAU
    AustriaAT
    AzerbaijanAZ
    Bahamas (the)BS
    BahrainBH
    BangladeshBD
    BarbadosBB
    BelarusBY
    BelgiumBE
    BelizeBZ
    BeninBJ
    BermudaBM
    Åland IslandsAX
    BhutanBT
    Bolivia (Plurinational State of)BO
    Bonaire, Sint Eustatius and SabaBQ
    Bosnia and HerzegovinaBA
    BotswanaBW
    Bouvet IslandBV
    BrazilBR
    British Indian Ocean Territory (the)IO
    Brunei DarussalamBN
    BulgariaBG
    Burkina FasoBF
    BurundiBI
    Cabo VerdeCV
    CambodiaKH
    CameroonCM
    CanadaCA
    Cayman Islands (the)KY
    Central African RepublicCF
    ChadTD
    ChileCL
    ChinaCN
    Christmas IslandCX
    Cocos (Keeling) Islands (the)CC
    ColombiaCO
    Comoros (the)KM
    Congo (the Democratic Republic of the)CD
    Congo (the)CG
    Cook Islands (the)CK
    Costa RicaCR
    CroatiaHR
    CubaCU
    CuraçaoCW
    CyprusCY
    CzechiaCZ
    Côte d'IvoireCI
    DenmarkDK
    DjiboutiDJ
    DominicaDM
    Dominican Republic (the)DO
    EcuadorEC
    EgyptEG
    El SalvadorSV
    Equatorial GuineaGQ
    EritreaER
    EstoniaEE
    Falkland Islands (the) [Malvinas]FK
    Faroe Islands (the)FO
    FijiFJ
    FinlandFI
    FranceFR
    French GuianaGF
    French PolynesiaPF
    French Southern Territories (the)TF
    GabonGA
    Gambia (the)GM
    GeorgiaGE
    GermanyDE
    GhanaGH
    GibraltarGI
    GreeceGR
    GreenlandGL
    GrenadaGD
    GuadeloupeGP
    GuamGU
    GuatemalaGT
    GuernseyGG
    GuineaGN
    Guinea-BissauGW
    GuyanaGY
    HaitiHT
    Heard Island and McDonald IslandsHM
    Holy See (the)VA
    HondurasHN
    Hong KongHK
    HungaryHU
    IcelandIS
    IndiaIN
    IndonesiaID
    Iran (Islamic Republic of)IR
    IraqIQ
    IrelandIE
    Isle of ManIM
    IsraelIL
    ItalyIT
    JamaicaJM
    JapanJP
    JerseyJE
    JordanJO
    KazakhstanKZ
    KenyaKE
    KiribatiKI
    Korea (the Democratic People's Republic of)KP
    Korea (the Republic of)KR
    KuwaitKW
    KyrgyzstanKG
    Lao People's Democratic Republic (the)LA
    LatviaLV
    LebanonLB
    LesothoLS
    LiberiaLR
    LibyaLY
    LiechtensteinLI
    LithuaniaLT
    LuxembourgLU
    MacaoMO
    MadagascarMG
    MalawiMW
    MalaysiaMY
    MaldivesMV
    MaliML
    MaltaMT
    Marshall Islands (the)MH
    MartiniqueMQ
    MauritaniaMR
    MauritiusMU
    MayotteYT
    MexicoMX
    Micronesia (Federated States of)FM
    Moldova (the Republic of)MD
    MonacoMC
    MongoliaMN
    MontenegroME
    MontserratMS
    MoroccoMA
    MozambiqueMZ
    MyanmarMM
    NamibiaNA
    NauruNR
    NepalNP
    Netherlands (Kingdom of the)NL
    New CaledoniaNC
    New ZealandNZ
    NicaraguaNI
    Niger (the)NE
    NigeriaNG
    NiueNU
    Norfolk IslandNF
    North MacedoniaMK
    Northern Mariana Islands (the)MP
    NorwayNO
    OmanOM
    PakistanPK
    PalauPW
    Palestine, State ofPS
    PanamaPA
    Papua New GuineaPG
    ParaguayPY
    PeruPE
    Philippines (the)PH
    PitcairnPN
    PolandPL
    PortugalPT
    Puerto RicoPR
    QatarQA
    RomaniaRO
    Russian Federation (the)RU
    RwandaRW
    ReunionRE
    Saint BarthélemyBL
    Saint Helena, Ascension and Tristan da CunhaSH
    Saint Kitts and NevisKN
    Saint LuciaLC
    Saint Martin (French part)MF
    Saint Pierre and MiquelonPM
    Saint Vincent and the GrenadinesVC
    SamoaWS
    San MarinoSM
    Sao Tome and PrincipeST
    Saudi ArabiaSA
    SenegalSN
    SerbiaRS
    SeychellesSC
    Sierra LeoneSL
    SingaporeSG
    Sint Maarten (Dutch part)SX
    SlovakiaSK
    SloveniaSI
    Solomon IslandsSB
    SomaliaSO
    South AfricaZA
    South Georgia and the South Sandwich IslandsGS
    South SudanSS
    SpainES
    Sri LankaLK
    Sudan (the)SD
    SurinameSR
    Svalbard and Jan MayenSJ
    SwedenSE
    SwitzerlandCH
    Syrian Arab Republic (the)SY
    Taiwan (Province of China)TW
    TajikistanTJ
    Tanzania, the United Republic ofTZ
    ThailandTH
    Timor-LesteTL
    TogoTG
    TokelauTK
    TongaTO
    Trinidad and TobagoTT
    TunisiaTN
    TurkmenistanTM
    Turks and Caicos Islands (the)TC
    TuvaluTV
    TürkiyeTR
    UgandaUG
    UkraineUA
    United Arab Emirates (the)AE
    United Kingdom of Great Britain and Northern Ireland (the)GB
    United States Minor Outlying Islands (the)UM
    United States of America (the)US
    UruguayUY
    UzbekistanUZ
    VanuatuVU
    Venezuela (Boliviarian Republic of)VE
    Viet NamVN
    Virgin Islands (British)VG
    Virgin Islands (U.S.)VI
    Wallis and FutunaWF
    Western SaharaEH
    YemenYE
    ZambiaZM
    ZimbabweZW
  • Example: VN

Beneficiary Bank Branch Identification

  • Description: Identification of the bank branch of the financial institution servicing the beneficiary account.
  • Expected data format: Any string, up to 35 characters
  • Example: Sacombank Ho Chi Minh

Beneficiary Financial Institution Name

  • Description: Name of the financial institution servicing the beneficiary.
  • Possible values: TRANGLO
  • Example: TRANGLO

End-to-End ID

  • Description: Unique ID that the sender specifies and which persists across all RippleNet instances that participate in the payment.
  • Expected data format: String, up to 32 alphanumeric characters
  • Example: d485f100-2af7-4e48-9ab1-3c7e28775691

Internal ID

  • Description: A unique, user-assigned ID assigned to a transaction for internal communication and tracking.
  • Expected data format: String, up to 64 alphanumeric characters
  • Example: 123456789ABC987654321

Charge Bearer

  • Description: ISO ChargeBearerType1 code that specifies which party or parties will bear the charges associated with the processing of the payment transaction.
  • Possible values: DEBT -- Debtor
  • Example: DEBT