> ## Documentation Index > Fetch the complete documentation index at: https://developer.meow.com/llms.txt > Use this file to discover all available pages before exploring further. # 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`. ## OpenAPI ````yaml POST /accounts/{account_id}/international openapi: 3.1.0 info: title: Meow API description: > ## Overview The Meow API provides financial services and billing capabilities for your business. ### Core Features - **Financial data access**: access account information, transactions, balances, and payment networks. - **Crypto operations**: create and manage crypto contacts, and initiate USDC transfers across blockchain networks. ### Billing API The Billing API lets you create and manage invoices and collect payments: - **Product management**: create and manage products with custom pricing. - **Customer management**: maintain invoicing customers with their addresses. - **Invoice creation**: generate invoices with line items, discounts, and custom notes. - **Payment options**: accept payments via ACH, wire, international wire, card, and USDC. - **Collection accounts**: configure accounts for payment collection. ### Getting Started Authenticate by sending your API key in the `x-api-key` request header. To scope requests to a specific entity, include the `x-entity-id` header. Use the `/api-keys/accessible-entities` endpoint to list all entities accessible by your API key. ### Error Responses Errors return JSON with `code`, `message`, and `debug_message`. The `code` aligns with FDX where possible; use `debug_message` for troubleshooting only. Common error codes: - `500`: Internal server error - `501`: Subsystem unavailable - `503`: Scheduled maintenance - `601`: Data not found - `602`: Customer not authorized - `701`: Account not found - `703`: Invalid input (including invalid date ranges) - `704`: Account type not supported - `705`: Account is closed - `801`: Transaction not found contact: name: Meow url: https://meow.com/ email: support@meow.com version: 1.0.0 license: name: Proprietary url: https://www.meow.com/terms-of-service servers: - url: https://api.meow.com/v1 description: Meow API Production - url: https://api.sandbox.meow.com/v1 description: Meow API Sandbox - url: https://api.dev.meow.com/v1 description: Meow API Development security: - apiKeyAuth: [] tags: - name: API Keys description: Retrieve metadata about API keys and their accessible entities. - name: Accounts description: Access and manage accounts. - name: Approvals - name: Balances description: Retrieve account balances and available funds. - name: Bills description: View and manage bills for vendor payments. - name: Cards description: Manage virtual and physical cards, and view transactions and insights. - name: Collection Accounts description: Manage accounts for payment collection. - name: Contacts description: Manage contacts for crypto and USDC transfers. - name: Customers description: Manage invoicing customers and their details. - name: Entities - name: Invoices description: Create and manage invoices. - name: Limits - name: Line Items description: Manage invoice line items. - name: Partner Onboarding description: Onboard entities using your partner API key. - name: Partner Webhooks - name: Payment Methods description: View available payment method types. - name: Payment Networks description: Manage payment networks and routing information. - name: Products description: Manage products and pricing for invoicing. - name: Routing Numbers description: Validate routing numbers and retrieve bank information. - name: Security Policies - name: Simulations description: >- Trigger simulated events (inbound transfers, card authorizations, application approval) to test integrations end-to-end without real money movement. **Not available in production**: these endpoints exist only in sandbox and development environments and return `404 Not Found` in production. - name: Tax Forms description: Retrieve IRS tax forms (1099 family) issued for accounts. - name: Transactions description: Retrieve account transaction history and details. - name: Transfers description: >- Initiate ACH, wire, book, and crypto transfers, and retrieve transfer details. - name: Webhooks description: Manage webhook subscriptions and inspect delivery history. paths: /accounts/{account_id}/international: post: tags: - Transfers summary: Create International Payment description: >- 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`. operationId: create_international_payment_accounts__account_id__international_post parameters: - name: account_id in: path required: true schema: type: string description: The account the payment is funded from. title: Account Id description: The account the payment is funded from. - name: Idempotency-Key in: header required: true schema: type: string minLength: 1 maxLength: 50 pattern: ^[!-~]+$ description: >- 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. title: Idempotency-Key description: >- 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. - $ref: '#/components/parameters/EntityIdHeader' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreateInternationalPaymentRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/CreateInternationalPaymentResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - apiKeyAuth: - transfers:international:write components: parameters: EntityIdHeader: name: x-entity-id in: header required: false schema: type: string format: uuid description: Optional `entity_id` to scope requests to a specific entity. schemas: CreateInternationalPaymentRequest: properties: contact_id: type: string format: uuid title: Contact Id description: >- Contact to pay. The contact must already have international payment details saved. Use list_contacts to find one. recipient_amount: anyOf: - type: number exclusiveMinimum: 0 - type: string pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,2}0*$ - type: 'null' title: Recipient Amount description: >- How 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. source_amount: anyOf: - type: number exclusiveMinimum: 0 - type: string pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,2}0*$ - type: 'null' title: Source Amount description: >- US 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. recipient_currency: $ref: '#/components/schemas/Iso4217Code' description: Currency the recipient is paid in. purpose: type: string minLength: 1 title: Purpose description: >- 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. purpose_code: anyOf: - $ref: '#/components/schemas/InternationalPaymentPurposeCode' - type: 'null' description: >- A destination-specific classification of the payment. Required for some destination currencies and countries; when it is required and missing, the error names it. invoice_number: anyOf: - type: string - type: 'null' title: Invoice Number description: >- 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. invoice_date: anyOf: - type: string format: date - type: 'null' title: Invoice Date description: >- Date of the invoice this payment settles. Required for some destination currencies and countries. reference: anyOf: - type: string maxLength: 140 minLength: 1 - type: 'null' title: Reference description: >- Reference shown to the recipient, where the destination rail supports one. type: object required: - contact_id - recipient_currency - purpose title: CreateInternationalPaymentRequest CreateInternationalPaymentResponse: properties: approval_id: type: string format: uuid title: Approval Id description: >- Handle for this payment. Poll `GET /approvals/{approval_id}` to learn the outcome. status: $ref: '#/components/schemas/InternationalPaymentRequestStatus' description: >- `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. contact_id: type: string format: uuid title: Contact Id description: Contact being paid. recipient_amount: type: string pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ title: Recipient Amount description: How much the recipient receives. recipient_currency: $ref: '#/components/schemas/Iso4217Code' description: Currency the recipient is paid in. source_amount: type: string pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ title: Source Amount description: >- 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. fee_amount: type: string pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ title: Fee Amount description: Meow's fee for the conversion, in US dollars. total_amount: type: string pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$ title: Total Amount description: >- US dollars debited in total, fee included. This is the figure your approval rules are evaluated against. created_time: type: integer title: Created Time description: When the payment was requested, as a Unix timestamp. message: anyOf: - type: string - type: 'null' title: Message description: Present when the payment needs approval, to say so. type: object required: - approval_id - status - contact_id - recipient_amount - recipient_currency - source_amount - fee_amount - total_amount - created_time title: CreateInternationalPaymentResponse HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError Iso4217Code: type: string enum: - 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 title: Iso4217Code InternationalPaymentPurposeCode: type: string enum: - 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 title: InternationalPaymentPurposeCode x-enum-varnames: - 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 InternationalPaymentRequestStatus: type: string enum: - processing - pending_approval title: InternationalPaymentRequestStatus x-enum-varnames: - processing - pending_approval ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError securitySchemes: apiKeyAuth: type: apiKey in: header name: x-api-key description: Your Meow API key, sent in the `x-api-key` header for authentication. x-scopes: - accounts:read - accounts:write - accounts:payment-networks - accounts:transactions - accounts:balances - accounts:statements - accounts:tax-documents - entity:create - transfers:crypto:write - transfers:usdc:write - transfers:ach:write - transfers:wire:write - transfers:book:write - transfers:international:write - contacts:read - contacts:write - billing:products:read - billing:products:write - billing:customers:read - billing:customers:write - billing:invoices:read - billing:invoices:write - billing:accounts:read - billpay:read - billpay:write - onboarding:read - onboarding:write - cards:read - cards:write - webhooks:read - webhooks:write - partner:onboarding:read - partner:onboarding:write - partner:webhooks:read - partner:webhooks:write - simulations:write - banking:limits:read - banking:limits:write ````