Skip to content
APIs/Parties/
/
PayPal

← Back to Account Payouts docs
← Back to Parties docs

PayPal

Overview

AvailableComing soon
targetCurrencyMust be USD, EUR, GBP
countryCodeBeneficiary's country of their residential (if payee is an individual) or registered (if payee is a company) address.
Enter the 2 character ISO 3166-1 standard country code in your API request.
Please refer to the below list of countries where USDC payouts are prohibited or unsupported.
Earliest beneficiary creditreal-time
Cut-off time (UTC)N/A
Decimal places2
Minimum targetAmount$0.01
Maximum targetAmountUSD equivalent
$60,000 (PayPal), $20,000 (Venmo)

Submission data

API field nameRequired?Field lengthDescription
channel✅N/AMust be:
  • paypal
purposeOfPayment.description✅N/AType of PayPal payout, whether to PayPal or Venmo account.
Must be:
  • PAYPAL
  • VENMO - US Payouts only
beneficiaryWalletDetails.walletIdentifierType✅N/AMethod to make payment to specific PayPal or Venmo account.
Must be:
  • email
  • phoneNumber
  • walletId
beneficiaryWalletDetails.walletIdentifierConditional1-64Beneficiary PayPal ID or Venmo user handle.
Condition
Mandatory if beneficiaryWalletDetails.walletIdentifierType is:
  • walletId
parties.partyType✅N/AType of the party.
Must be:
  • beneficiary
parties.personalDetails.type✅N/AEntity description code for the party.
Available values:
  • company
  • person
  • soleTrader
  • institution
  • government
  • other
parties.personalDetails.titleConditionalN/ATitle code for the individual.
Available values:
  • ms
  • mrs
  • mr
  • miss
  • dr
  • mx
  • misc
Condition
Mandatory if parties.personalDetails.type is:
  • person
parties.personalDetails.firstNameConditionalMax 50Beneficiary first name. Full name should be provided (no initials).
Condition
Mandatory if parties.personalDetails.type is:
  • person
parties.personalDetails.middleName❌Max 50Beneficiary middle name.
parties.personalDetails.lastNameConditionalMax 50Beneficiary last name. Full name should be provided (no initials).
Condition
Mandatory if parties.personalDetails.type is:
  • person
parties.personalDetails.companyNameConditionalMax 140Full name of the organization.
Important
Failure to provide the full name could result in delays and potential rejection of your payment. This must consist of 2 words, separated by a space. To whitelist any other naming format please contact your Relationship Manager.
Condition
Mandatory if parties.personalDetails.type is:
  • company
  • institution
  • government
  • other
parties.personalDetails.dateOfBirthStrongly recommended10Beneficiary's date of birth in YYYY-MM-DD format.
parties.personalDetails.dateOfIncorporation❌10A company's date of incorporation in YYYY-MM-DD format.
parties.personalDetails.emailConditionalMax 50Beneficiary's email address.
Condition
Mandatory if beneficiaryWalletDetails.walletIdentifierType is:
  • email
parties.personalDetails.phones.numberConditional5-20Phone number of the beneficiary.
Condition
Mandatory if beneficiaryWalletDetails.walletIdentifierType is:
  • phoneNumber
parties.personalDetails.phones.prefixConditional1-3Phone country dialing code of the beneficiary.
Condition
Mandatory if beneficiaryWalletDetails.walletIdentifierType is:
  • phoneNumber
parties.address.address1✅Max 35Beneficiary's residential (if payee is an individual) or registered (if payee is a company) house number/name and street e.g. 1 Main Street.
parties.address.address2❌Max 35Beneficiary's residential (if payee is an individual) or registered (if payee is a company) address e.g. apartment no., unit, studio.
parties.address.city✅Max 35Beneficiary's city or town of their residential (if payee is an individual) or registered (if payee is a company) address.
parties.address.state✅Max 35Beneficiary's state code of residential address (if payee is an individual) or registered address (if payee is a company).
parties.address.postalCode✅Max 10Beneficiary's postal code or zip code of their residential (if payee is an individual) or registered (if payee is a company) address.
parties.address.countryCode✅2Beneficiary's country of their residential (if payee is an individual) or registered (if payee is a company) address.
Enter the 2 character ISO 3166-1 standard country code in your API request.