Create International Payment
Pays a contact in their local currency, converting from US dollars at the rate quoted when you call. Fix either leg: give recipient_amount to send an exact amount in their currency, or source_amount to spend an exact number of US dollars. Preview the rate and fee first with POST /accounts/{account_id}/international/quote. The contact must already have international payment details saved. To send US dollars instead, including to a bank outside the US, use POST /accounts/{account_id}/wire.
Authorizations
Your Meow API key, sent in the x-api-key header for authentication.
Headers
A unique key you generate (1-50 printable ASCII characters, no spaces) so retrying this request never creates a duplicate. Reusing a key is rejected.
1 - 50^[!-~]+$Optional entity_id to scope requests to a specific entity.
Path Parameters
The account the payment is funded from.
Body
Contact to pay. The contact must already have international payment details saved. Use list_contacts to find one.
Currency the recipient is paid in.
AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BOV, BRL, BSD, BTN, BWP, BYN, BZD, CAD, CDF, CHE, CHF, CHW, CLF, CLP, CNY, COP, COU, CRC, CUC, CUP, CVE, CZK, DJF, DKK, DOP, DZD, EGP, ERN, ETB, EUR, FJD, FKP, GBP, GEL, GHS, GIP, GMD, GNF, GTQ, GYD, HKD, HNL, HRK, HTG, HUF, IDR, ILS, INR, IQD, IRR, ISK, JMD, JOD, JPY, KES, KGS, KHR, KMF, KPW, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, LSL, LYD, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MRU, MUR, MVR, MWK, MXN, MXV, MYR, MZN, NAD, NGN, NIO, NOK, NPR, NZD, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, RWF, SAR, SBD, SCR, SDG, SLE, SEK, SGD, SHP, SLL, SOS, SRD, SSP, STN, SVC, SYP, SZL, THB, TJS, TMT, TND, TOP, TRY, TTD, TWD, TZS, UAH, UGX, USD, USN, UYI, UYU, UYW, UZS, VED, VES, VND, VUV, WST, XAF, XAG, XAU, XBA, XBB, XBC, XBD, XCD, XDR, XOF, XPD, XPF, XPT, XSU, XTS, XUA, XXX, YER, ZAR, ZMW, ZWG, ZWL Why the money is being sent. Required for every destination, and some destinations reject a purpose that is too short or too vague. Anything longer than 50 characters is rejected.
1How much the recipient receives, in recipient_currency. The dollar amount debited is derived from this at the current rate. Give this or source_amount, never both.
x > 0US dollars to convert, before the fee. What the recipient receives is derived from this at the current rate. Give this or recipient_amount, never both.
x > 0A destination-specific classification of the payment. Required for some destination currencies and countries; when it is required and missing, the error names it.
advertising, advisor_fees, construction, education, exports, family, fund_investment, goods, hotel, insurance_claims, insurance_premium, loan_repayment, medical, other_fees, property_purchase, property_rental, royalties, services, tax, transfer, travel, utilities, business_insurance, delivery, office, share_investment, transportation, ACM, AES, AFA, AFL, ALW, ATS, BON, CCP, CEA, CEL, CHC, CIN, COM, COP, CRP, DCP, DIV, DLA, DLF, DLL, DOE, DSA, DSF, DSL, EDU, EMI, EOS, FAM, FDA, FDL, FIA, FIL, FIS, FSA, FSL, GDE, GDI, GMS, GOS, GRI, IFS, IGD, IGT, IID, INS, IOD, IOL, IPC, IPO, IRP, IRW, ISH, ISL, ISS, ITS, LAS, LDL, LDS, LEA, LEL, LIP, LLA, LLL, LNC, LND, MCR, MWI, MWO, MWP, OAT, OTS, OVT, PEN, PIN, PIP, PMS, POR, POS, PPA, PPL, PRP, PRR, PRS, PRW, RDS, RFS, RLS, RNT, SAA, SAL, SCO, SLA, SLL, STR, STS, SVI, SVO, SVP, TCP, TCR, TCS, TKT, TOF, TTS, UTL Reference of the invoice this payment settles. Required for some destination currencies and countries. Anything that is not a letter or a digit is removed and the result is cut to 30 characters before it reaches the banking partner; an INR payment needs what remains to be non-empty.
Date of the invoice this payment settles. Required for some destination currencies and countries.
Reference shown to the recipient, where the destination rail supports one.
1 - 140Response
Successful Response
Handle for this payment. Poll GET /approvals/{approval_id} to learn the outcome.
processing means the payment was accepted and is being sent. pending_approval means someone must approve it in the Meow dashboard before any money moves.
processing, pending_approval Contact being paid.
How much the recipient receives.
^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$Currency the recipient is paid in.
AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BOV, BRL, BSD, BTN, BWP, BYN, BZD, CAD, CDF, CHE, CHF, CHW, CLF, CLP, CNY, COP, COU, CRC, CUC, CUP, CVE, CZK, DJF, DKK, DOP, DZD, EGP, ERN, ETB, EUR, FJD, FKP, GBP, GEL, GHS, GIP, GMD, GNF, GTQ, GYD, HKD, HNL, HRK, HTG, HUF, IDR, ILS, INR, IQD, IRR, ISK, JMD, JOD, JPY, KES, KGS, KHR, KMF, KPW, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, LSL, LYD, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MRU, MUR, MVR, MWK, MXN, MXV, MYR, MZN, NAD, NGN, NIO, NOK, NPR, NZD, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, RWF, SAR, SBD, SCR, SDG, SLE, SEK, SGD, SHP, SLL, SOS, SRD, SSP, STN, SVC, SYP, SZL, THB, TJS, TMT, TND, TOP, TRY, TTD, TWD, TZS, UAH, UGX, USD, USN, UYI, UYU, UYW, UZS, VED, VES, VND, VUV, WST, XAF, XAG, XAU, XBA, XBB, XBC, XBD, XCD, XDR, XOF, XPD, XPF, XPT, XSU, XTS, XUA, XXX, YER, ZAR, ZMW, ZWG, ZWL US dollars converted to fund the payment, at the rate quoted when you called. The final debit is set when the payment executes and can differ slightly if the rate moves.
^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$Meow's fee for the conversion, in US dollars.
^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$US dollars debited in total, fee included. This is the figure your approval rules are evaluated against.
^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$When the payment was requested, as a Unix timestamp.
Present when the payment needs approval, to say so.