Payment purpose codes

payment purpose codes intro p ayment p urpose c odes (ppcs), also known as payment reason codes, are standardized identifiers that provide the reason for a crossborder or international payment ppcs enable payers to categorize the payment, whether for goods, services, investments, or other purposes in crossborder payments, ppcs add an additional layer of transparency by ensuring funds are used for legitimate purposes and are considered mandatory or required fields by the central banking authority in certain jurisdictions, i e india, malaysia, and the united arab emirates payment origination all outbound payments where the “to” currency is one of inr (india), myr (malaysia), and aed (united arab emirates) require the use of the payment purpose code field to be populated with the corresponding ppc for the respective currency the following api fields, found in the docid\ onbkgebihvb4ihvb1hakl endpoint are associated with payment purpose codes purposecode invoicenumber see docid\ kmgw82p6bkyzjx aojtae invoicedate see docid\ kmgw82p6bkyzjx aojtae payment types there are specific types of payments for each of these countries that require payment purpose codes they are as follows true 133,135 40136054421765,392 59863945578235 unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type india (inr) true 160,226,144 62240663900417,215 37759336099583 unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type important restrictions local inr payments are not supported for the following purpose codes salary, product indemnity insurance, and investment in shares trade related inr payments to a hdfc beneficiary bank and inr payments to any beneficiary bank using the code ‘delivery delivery fees for goods’ are also not supported trade payments compliance for trade related payments, invoicenumber and invoicedate are required maximum 1 5m inr per beneficiary account per day under rda limits charity restrictions only the following organizations are supported unicef, prime minister relief fund, international red cross sample code sample response for the /international/v1/quotes endpoint for india containing a payment purpose code request for payment quote for india for ppc { "currency" "inr", "accountnumber" "158560897123", "fromamount" "500", "toamount" "", "beneficiary" { "firstname" "jon", "lastname" "smith", //"companyname" "", "fullname" "jonsmith", //"email" "js\@smith com", "birthdate" "2001 06 18t13 05 09 015z", "address" "1 street", "city" "winfield", "stateprovince" "", "postalcode" "in12345", "countrycode" "in", "entitytype" "individual" }, "beneficiaryfi" { "bankname" "bank in", "bankcountrycode" "in", "bankaddress" "1 avenue", "bankaccounttype" "checking", "routingcodetype1" "sortcode", "routingcodevalue1" "123456789", "routingcodetype2" "aba", "routingcodevalue2" "123456789", "bicswift" "tgclgb99", "iban" "in33bukb20201555555555" }, "priority" true, //"conversionfeebps" 10, //"transactionfeeamount" 10, "purposecode" "exports", "invoicenumber" "12345", "invoicedate" "20250809" "purpose" "srv" } response for request a payment quote api { "id" "ea5a8df9 26ea 4ac7 8f0f b35a00c61234", "accountnumber" "158560897007", "currency" "inr", "beneficiary" { "companyname" "tech importers india pvt ltd", "email" "accounts\@techimporters in", "address" "23 industrial road", "city" "bangalore", "stateprovince" "ka", "postalcode" "560001", "countrycode" "in", "entitytype" "company" }, "beneficiaryfi" { "bankname" "icici bank", "bankcountrycode" "in", "bankaddress" "mg road", "bankaccounttype" "checking", "accountnumber" "123456789012", "routingcodetype1" "ifsc", "routingcodevalue1" "icic0001234" }, "fromamount" 1500000, "toamount" 123966750, "transactionfee" 100, "conversionrate" 82 6445, "estimateddeliverydate" "2025 09 17", "expiresat" "2025 09 16t08 05 27 1354807 04 00", "status" "created", "priority" false, "paymentnetwork" "regular", "purpose" "export of goods", "purposecode" "exports", "invoicenumber" "inv 20250825 001", "invoicedate" "2025 08 25t06 00 00 04 00" } malaysia (myr) true 186,287 4972170686456,287 5027829313544 unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type united arab emirates (ued) true 116,470 34802784222734,174 65197215777266 unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type