The exchange currency API to convert one currency to another one.
Purpose:
The PayPal Exchange Rate Quote API enables businesses to dynamically display prices in multiple currencies by generating exchange rate quotes for currency pair.
FX Rate Guarantee: Guarantees exchange rates for a specified duration, ensuring stability and consistency in currency presentment scenarios.
Customizable Pricing: Provides flexible exchange rate options tailored to business needs, allowing customization through negotiated rates and dynamic pricing models to align with business requirements.
Provides functionality to source wholesale market rates with the addition of a percentage-based currency conversion fee. This enables the delivery of retail exchange rates without offering a rate guarantee.
FX Rate Revenue Markup: Offers merchants the flexibility to apply customized markups on exchange rates, allowing them to generate additional revenue from currency conversions. Enables businesses to define their own pricing strategies by setting adjustable markups based on transaction volume, customer segments, or market conditions, ensuring greater control over foreign exchange earnings while maintaining competitive pricing for end users.
Need a Guaranteed Rate for a Certain Timeframe: Businesses want to lock in an exchange rate for a defined period to protect against market fluctuations and reduce the risk of FX volatility.
Offer Customers Stable, Upfront Pricing for a Limited Time: Displaying FX rates but ensuring the rate remains fixed for a short duration, allowing customers to complete their purchase without unexpected price changes.
Integrate with PayPal as Payment Processor for Real-Time Quoting Scenarios: Leveraging PayPal’s payment processing capabilities, ensuring seamless multi-currency support.
A successful request returns the HTTP 200 OK
status code and a JSON response body that shows quote exchange rate details.
Request is not well-formed, syntactically incorrect, or violates schema.
The authorization failed due to insufficient permissions.
An internal server error has occurred.
{- "quote_items": [
- {
- "base_currency": "USD",
- "base_amount": "16.80",
- "quote_currency": "GBP",
- "markup_percent": "1"
}
]
}
{- "exchange_rate_quotes": [
- {
- "base_amount": {
- "currency_code": "USD",
- "value": "16.80"
}, - "quote_amount": {
- "currency_code": "GBP",
- "value": "13.80"
}, - "exchange_rate": "0.80956391984",
- "expiry_time": "2022-03-10T21:30:00Z",
- "rate_refresh_time": "2022-03-10T18:30:00Z",
- "fx_id": "MTFFQy05RjkzLTQ4ODkwMjE5LUEzRTAtREQ4OTc1NEQ1NUUw"
}
]
}
A postal address at which the user can be contacted.
address_line_1 | string <= 300 characters The first line of the address. For example, number or street. For example, |
address_line_2 | string <= 300 characters The second line of the address. For example, suite or apartment number. |
address_line_3 | string <= 100 characters The third line of the address, if needed. For example, a street complement for Brazil, direction text, such as |
admin_area_4 | string <= 100 characters The neighborhood, ward, or district. Smaller than
|
admin_area_3 | string <= 100 characters A sub-locality, suburb, neighborhood, or district. Smaller than
|
admin_area_2 | string <= 120 characters A city, town, or village. Smaller than |
admin_area_1 | string <= 300 characters The highest level sub-division in a country, which is usually a province, state, or ISO-3166-2 subdivision. Format for postal delivery. For example,
|
postal_code | string <= 60 characters The postal code, which is the zip code or equivalent. Typically required for countries with a postal code or an equivalent. See postal code. |
country_code required | string <ppaas_common_country_code_v2> (country_code) = 2 characters ^([A-Z]{2}|C2)$ The two-character ISO 3166-1 code that identifies the country or region. Note: The country code for Great Britain is |
object (Address Details) The non-portable additional address details that are sometimes needed for compliance, risk, or other scenarios where fine-grain address information might be needed. Not portable with common third party and open source. Redundant with core fields. | |
id | string [ 1 .. 20 ] characters Unique identifier for this address for this user. |
addressee_name | string [ 1 .. 300 ] characters The name that should go on the mailing label with the address. For use in specifying a recipient that is not the user, required on shipping addresses. |
address_confirmation_status | string The confirmation status of the postal address. |
{- "address_line_1": "string",
- "address_line_2": "string",
- "address_line_3": "string",
- "admin_area_4": "string",
- "admin_area_3": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st",
- "address_details": {
- "street_number": "string",
- "street_name": "string",
- "street_type": "string",
- "delivery_service": "string",
- "building_name": "string",
- "sub_building": "string"
}, - "id": "string",
- "addressee_name": "string",
- "address_confirmation_status": "string"
}
The specific type of the balance account.
The specific type of the balance account.
Enum Value | Description |
---|---|
STANDARD_BALANCE_ACCOUNT | Standard balance account. |
STANDARD_GOAL_ACCOUNT | Standard goal account. |
STANDARD_SAVINGS_ACCOUNT | Standard savings account. |
STANDARD_POOL_ACCOUNT | Standard pool account. |
"STANDARD_BALANCE_ACCOUNT"
This is the placeholder to represent all the business related contact information. There could be several types of business contacts. for eg: location, shipping, billing. Billing and Shipping can be same as primary location as well, in those cases there is no need to define shipping and billing separately.
contact_type | string [ 1 .. 50 ] characters ^[0-9A-Z_]+$ The type of contact information of merchant.
| ||||||
object (Address) Business address of type of contact_type. | |||||||
email_address | string <ppaas_common_email_address_v2> (email_address) [ 3 .. 254 ] characters ^.+@[^"\-].+$ The email provided by the party for the payment. | ||||||
object (Phone info) The merchant-provided phone associated to contact_type. |
{- "contact_type": "SHIPPING_LOCATION",
- "address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "address_line_3": "string",
- "admin_area_4": "string",
- "admin_area_3": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st",
- "address_details": {
- "street_number": "string",
- "street_name": "string",
- "street_type": "string",
- "delivery_service": "string",
- "building_name": "string",
- "sub_building": "string"
}, - "id": "string",
- "addressee_name": "string",
- "address_confirmation_status": "string"
}, - "email_address": "string",
- "phone": {
- "phone_type": "FAX",
- "phone_number": {
- "country_code": "str",
- "national_number": "string",
- "extension_number": "string"
}
}
}
The financial instrument (FI) capabilities.
name | string [ 1 .. 255 ] characters ^[0-9A-Z_]+$ Capability name.
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
mode | string [ 1 .. 255 ] characters ^[0-9A-Z_]+$ The supported financial instrument (FI) mode.
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Array of objects (Network) [ 1 .. 100 ] items Networks for the Financial instrument. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
capability_initiator | string (capability_initiator) [ 1 .. 255 ] characters ^[0-9A-Z_]+$ Initiator of money movement.
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
operation_type | string (Operation Type) [ 1 .. 255 ] characters ^[0-9A-Z_]+$ Operation type.
|
{- "name": "INSTALLMENT",
- "mode": "NON_REAL_TIME",
- "networks": [
- {
- "preferred": true,
- "cross_border_transaction_supported": true,
- "supported_currencies": [
- "str"
], - "transfer_type": "WIRE",
- "mandate_enforcement": "SEPA",
- "network_rules": [
- "string"
], - "name": "ACCEL"
}
], - "capability_initiator": "PAYPAL",
- "operation_type": "CAPABILITY_OP_SINK"
}
Initiator of money movement.
Initiator of money movement.
Enum Value | Description |
---|---|
PAYPAL | Indicates PayPal initiate the money movement. |
EXTERNAL | Indicates the money movement initiate from the external. |
"PAYPAL"
Contract details specifies honor period, rate refresh details etc. of a contract.
rate_config_id | string [ 1 .. 4000 ] characters ([0-9]*) Rate_config_id uniquely identifies a currency pair contract. | ||||||
honor_period required | integer [ 1 .. 86400 ] Time in seconds to honor the rate. The honor period is upto 24 hours and can range from 1 to 86400 seconds. | ||||||
rounding_rule required | string [ 1 .. 50 ] characters ^[A-Z_]+$ Rounding rule for amount depending on the value.
| ||||||
recurrence_period required | string [ 1 .. 30 ] characters ^[A-Z_]+$ The Recurrence period for the rate to refresh. If the recurrence_period is DAILY then the rate will refreshed everyday at 12:00 AM and if the recurrence_period is WEEKLY then the rate will be refreshed every week at Monday 12:00 AM (PS: As of ISO standard, we have Monday as the first day of the week).
| ||||||
required | Array of objects (Rate refresh times.) [ 1 .. 1000 ] items Time in seconds when the rate will be refreshed based on the recurrence_period (DAILY,WEEKLY) attribute. | ||||||
base_currency required | string <ppaas_common_currency_code_v2> (currency_code) = 3 characters Three-letter ISO 4217 alphabetical currency code. | ||||||
quote_currency required | string <ppaas_common_currency_code_v2> (currency_code) = 3 characters Three-letter ISO 4217 alphabetical currency code. | ||||||
start_time required | string <ppaas_date_time_v3> (date_time) [ 20 .. 64 ] characters ^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|... Time when the honor rate will start. It is represented in ISO 8601 | ||||||
end_time required | string <ppaas_date_time_v3> (date_time) [ 20 .. 64 ] characters ^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|... Time when the honor rate will expire. It is represented in ISO 8601 | ||||||
status | string (Represents the operation status.) [ 1 .. 22 ] characters ^[A-Z_]+$ Represents the approved status.
|
{- "rate_config_id": "string",
- "honor_period": 1,
- "rounding_rule": "HALF_UP",
- "recurrence_period": "DAILY",
- "rate_refresh_times": [
- {
- "rate_refresh_time": "string",
- "rate_refresh_timezone": "string"
}
], - "base_currency": "str",
- "quote_currency": "str",
- "start_time": "stringstringstringst",
- "end_time": "stringstringstringst",
- "status": "APPROVED"
}
"string"
The two-character ISO 3166-1 code that identifies the country or region.
Note: The country code for Great Britain isGB
and notUK
as used in the top-level domain names for that country. Use theC2
country code for China worldwide for comparable uncontrolled price (CUP) method, bank card, and cross-border transactions.
The two-character ISO 3166-1 code that identifies the country or region.
Note: The country code for Great Britain isGB
and notUK
as used in the top-level domain names for that country. Use theC2
country code for China worldwide for comparable uncontrolled price (CUP) method, bank card, and cross-border transactions.
"st"
The 2-character ISO 3166-1 code that identifies the country or region.
Note: The country code for Great Britain isGB
and notUK
as used in the top-level domain names for that country. Use theC2
country code for China worldwide for comparable uncontrolled price (CUP) method, bank card, and cross-border transactions.
The 2-character ISO 3166-1 code that identifies the country or region.
Note: The country code for Great Britain isGB
and notUK
as used in the top-level domain names for that country. Use theC2
country code for China worldwide for comparable uncontrolled price (CUP) method, bank card, and cross-border transactions.
"st"
The 3-character ISO-4217 currency code that identifies the currency.
The 3-character ISO-4217 currency code that identifies the currency.
"str"
The date and time, in Internet date and time format. Seconds are required while fractional seconds are optional.
Note: The regular expression provides guidance but does not reject all invalid dates.
The date and time, in Internet date and time format. Seconds are required while fractional seconds are optional.
Note: The regular expression provides guidance but does not reject all invalid dates.
"stringstringstringst"
The internationalized email address.
Note: Up to 64 characters are allowed before and 255 characters are allowed after the@
sign. However, the generally accepted maximum length for an email address is 254 characters. The pattern verifies that an unquoted@
sign exists.
The internationalized email address.
Note: Up to 64 characters are allowed before and 255 characters are allowed after the@
sign. However, the generally accepted maximum length for an email address is 254 characters. The pattern verifies that an unquoted@
sign exists.
"string"
The error details.
name required | string The human-readable, unique name of the error. |
message required | string The message that describes the error. |
debug_id required | string The PayPal internal ID. Used for correlation purposes. |
information_link | string The information link, or URI, that shows detailed information about this error for the developer. |
Array of objects (Error Details) An array of additional details about the error. | |
Array of objects (Link Description) An array of request-related HATEOAS links. |
{- "name": "string",
- "message": "string",
- "debug_id": "string",
- "information_link": "string",
- "details": [
- {
- "field": "string",
- "value": "string",
- "location": "body",
- "issue": "string",
- "description": "string"
}
], - "links": [
- {
- "href": "string",
- "rel": "string",
- "method": "GET"
}
]
}
The error details. Required for client-side 4XX
errors.
field | string The field that caused the error. If this field is in the body, set this value to the field's JSON pointer value. Required for client-side errors. |
value | string The value of the field that caused the error. |
location | string Default: "body" The location of the field that caused the error. Value is |
issue required | string The unique, fine-grained application-level error code. |
description | string The human-readable description for an issue. The description can change over the lifetime of an API, so clients must not depend on this value. |
{- "field": "string",
- "value": "string",
- "location": "body",
- "issue": "string",
- "description": "string"
}
Exchange currency request.
bulk_id required | string [ 1 .. 45 ] characters .* The unique identifier for each bulk item, enabling the client to correlate request and response. | ||||||||||||
conversion_reason required | string [ 4 .. 1000 ] characters ^[A-Z_]+$ The reason for the currency exchange conversion.
| ||||||||||||
trade_type required | string [ 3 .. 1000 ] characters ^[A-Z_]+$ The type of the currency exchange.
| ||||||||||||
fx_id | string [ 1 .. 4000 ] characters ^[ -~]+$ A previous reference can be passed in to get a rate quote amount based on a previous rate. | ||||||||||||
required | object (Money) The from amount for currency exchange. | ||||||||||||
target_currency_code required | string <ppaas_common_currency_code_v2> (currency_code) = 3 characters The target currency code. |
{- "bulk_id": "string",
- "conversion_reason": "WITHDRAW",
- "trade_type": "BUY",
- "fx_id": "string",
- "amount": {
- "currency_code": "str",
- "value": "string"
}, - "target_currency_code": "str"
}
Exchange currency response.
bulk_id | string [ 1 .. 45 ] characters .* The unique identifier for each bulk item, enabling the client to correlate request and response. |
exchange_rate | string [ 1 .. 32 ] characters ^([0-9]+[.][0-9]+)$ The currency conversion exchange rate. |
fee_percent | string [ 1 .. 32 ] characters ^(-?[0-9]+|-?([0-9]+)?[.][0-9]+)$ The fee percentage applied for this currency conversion. |
reference_id | string [ 1 .. 4000 ] characters ^[a-zA-Z0-9!@#$&()\-`.+,/":;~_=]*$ The reference id to identify this conversion. |
object (Money) The from amount for currency exchange. | |
object (Money) The to amount for currency exchange. | |
object (Money) The usd equivalent to source amount | |
object (Money) The usd equivalent to target amount | |
object (Fee Data) In-depth information on the exchange currency fee applied to the order. | |
conversion_time | string <ppaas_date_time_v3> (date_time) [ 20 .. 64 ] characters ^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|... The time the conversion is done in ISO 8601. |
effective_time | string <ppaas_date_time_v3> (date_time) [ 20 .. 64 ] characters ^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|... The effective time of exchange rate in ISO 8601. |
{- "bulk_id": "string",
- "exchange_rate": "string",
- "fee_percent": "string",
- "reference_id": "string",
- "source_amount": {
- "currency_code": "str",
- "value": "string"
}, - "target_amount": {
- "currency_code": "str",
- "value": "string"
}, - "source_usd_amount": {
- "currency_code": "str",
- "value": "string"
}, - "target_usd_amount": {
- "currency_code": "str",
- "value": "string"
}, - "fee": {
- "fee_audit_trail_id": "string",
- "tags": [
- "GROSS_BILLING"
], - "transaction_amount": {
- "currency_code": "str",
- "value": "string"
}, - "total_fee": {
- "currency_code": "str",
- "value": "string"
}, - "percent_fee": "string",
- "fixed_fee": {
- "currency_code": "str",
- "value": "string"
}, - "partner_markup": "string"
}, - "conversion_time": "stringstringstringst",
- "effective_time": "stringstringstringst"
}
In-depth information on the fee applied to the order.
fee_audit_trail_id required | string [ 1 .. 500 ] characters ^[ -~]+$ Would determine how the spread is calculated. | ||||||||||||||||||||||||||||
tags | Array of strings (Pricing Tags) [ 1 .. 50 ] items List of properties to influence the pricing behavior.
| ||||||||||||||||||||||||||||
required | object (Money) transaction value of the order. | ||||||||||||||||||||||||||||
required | object (Money) Total monetary value of the fee. | ||||||||||||||||||||||||||||
percent_fee required | string <ppaas_common_percentage_v2> (percentage) ^((-?[0-9]+)|(-?([0-9]+)?[.][0-9]+))$ Percentage of the order applied in fee. | ||||||||||||||||||||||||||||
object (Money) The amount to be charged in fee from any transaction, irrespective of the quantity or transaction amount. | |||||||||||||||||||||||||||||
partner_markup | string <ppaas_common_percentage_v2> (percentage) ^((-?[0-9]+)|(-?([0-9]+)?[.][0-9]+))$ The client/partner provided markup that will be included in the exchange rate and later paid out to the client/partner. |
{- "fee_audit_trail_id": "string",
- "tags": [
- "GROSS_BILLING"
], - "transaction_amount": {
- "currency_code": "str",
- "value": "string"
}, - "total_fee": {
- "currency_code": "str",
- "value": "string"
}, - "percent_fee": "string",
- "fixed_fee": {
- "currency_code": "str",
- "value": "string"
}, - "partner_markup": "string"
}
Indicates the risk category of a merchant as per AML and Compliance checks.
Indicates the risk category of a merchant as per AML and Compliance checks.
Enum Value | Description |
---|---|
HIGH_RISK | Indicates that the merchant is identified as risky by AML and Compliance team. |
HIGH_RISK_WITH_EDD | Indicates that the merchant is identified as risky and requires Enhanced Due Diligence registration by AML and Compliance team. |
"HIGH_RISK"
The number in string format, and pattern supports JWT, Plain(account number of the instrument), Encrypted.
The number in string format, and pattern supports JWT, Plain(account number of the instrument), Encrypted.
"string"
The request-related HATEOAS link information.
href required | string The complete target URL. To make the related call, combine the method with this URI Template-formatted link. For pre-processing, include the |
rel required | string The link relation type, which serves as an ID for a link that unambiguously describes the semantics of the link. See Link Relations. |
method | string The HTTP method required to make the related call. |
{- "href": "string",
- "rel": "string",
- "method": "GET"
}
List of categories linked to contract_id. These are price category codes for each/multiple customers generated by the engine and cannot be x-enums.
Price category that is linked to the contract.
[- "string"
]
The capability network.
The capability network.
Enum Value | Description |
---|---|
ACCEL | Indicates ACCEL network support for given instrument. |
AMEX | Indicates AMEX network support for given instrument.. |
BACS | Indicates BACS network support for given instrument. |
BML | Indicates BML network support for given instrument. |
CB_NATIONALE | Indicates CB_NATIONALE network support for given instrument. |
CET | Indicates CET network support for given instrument. |
CETELEM | Indicates CETELEM network support for given instrument. |
CHAPS | Indicates CHAPS network support for given instrument. |
CHASENET | Indicates CHASENET network support for given instrument. |
CHINA_UNION_PAY | Indicates CHINA_UNION_PAY network support for given instrument. |
COFIDIS | Indicates COFIDIS network support for given instrument. |
COFINOGA | Indicates COFINOGA network support for given instrument. |
DELTA | Indicates DELTA network support for given instrument. |
DINERS | Indicates DINERS network support for given instrument. |
DISCOVER | Indicates DISCOVER network support for given instrument. |
EFTPOS | Indicates EFTPOS network support for given instrument. |
ELECTRON | Indicates ELECTRON network support for given instrument. |
ELO | Indicates ELO network support for given instrument. |
FPS | Indicates FPS network support for given instrument. |
GE | Indicates GE network support for given instrument. |
HIPER | Indicates HIPER network support for given instrument. |
HIPERCARD | Indicates HIPERCARD network support for given instrument. |
IAV_YODLEE | Indicates IAV_YODLEE network support for given instrument. |
JCB | Indicates JCB network support for given instrument. |
LOCAL | Indicates LOCAL network support for given instrument. |
MAESTRO | Indicates MAESTRO network support for given instrument. |
MASTER_CARD | Indicates MASTER_CARD network support for given instrument. |
NYCE | Indicates NYCE network support for given instrument. |
OPEN_WALLET | Indicates OPEN_WALLET network support for given instrument. |
PAYPAL | Indicates PAYPAL network support for given instrument. |
POSTEPAY | Indicates POSTEPAY network support for given instrument. |
PULSE | Indicates PULSE network support for given instrument. |
PWMB | Indicates PWMB network support for given instrument. |
RUPAY | Indicates RUPAY network support for given instrument. |
SAN | Indicates SAN network support for given instrument. |
SEPA | Indicates SEPA network support for given instrument. |
SEPA_COR1 | Indicates SEPA_COR1 network support for given instrument. |
SEPA_CORE | Indicates SEPA_CORE network support for given instrument. |
SOLO | Indicates SOLO network support for given instrument. |
SSG | Indicates SSG network support for given instrument. |
STAR | Indicates STAR network support for given instrument. |
STAR_FINANZ | Indicates STAR_FINANZ network support for given instrument. |
STAR_ACCESS | Indicates STAR_ACCESS network support for given instrument. |
SWITCH | Indicates SWITCH network support for given instrument. |
VISA | Indicates VISA network support for given instrument. |
WIRE | Indicates WIRE network support for given instrument. |
FASTER_CLEARING | Indicates FASTER_CLEARING network support for given instrument. |
SYNCHRONY_FINANCIAL_SUPPORT | Indicates Synchrony Financial network support for given instrument. |
REAL_TIME_PAYMENTS | Indicates REAL_TIME_PAYMENTS network support for given instrument. |
"ACCEL"
Indicates the type of segment merchant comes under in his business segment.
Indicates the type of segment merchant comes under in his business segment.
Enum Value | Description |
---|---|
LE | Indicates the merchant belongs to Large Enterprise segment. |
SMB | Indicates the merchant belongs to Small Medium Business segment. |
"LE"
The currency and amount for a financial transaction, such as a balance or payment due.
currency_code required | string <ppaas_common_currency_code_v2> (currency_code) = 3 characters The 3-character ISO-4217 currency code that identifies the currency. |
value required | string <= 32 characters ^((-?[0-9]+)|(-?([0-9]+)?[.][0-9]+))$ The value, which might be:
|
{- "currency_code": "str",
- "value": "string"
}
The capability network.
preferred | boolean Indicates whether the network is the preferred network to complete the operation. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
cross_border_transaction_supported | boolean Is cross border transaction supported. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
supported_currencies | Array of strings <ppaas_common_currency_code_v2> (currency_code) [ 1 .. 100 ] items Supported currencies for the instrument. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
transfer_type | string [ 1 .. 255 ] characters ^[0-9A-Z_]+$ Transfer type for particular network.
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
mandate_enforcement | string [ 1 .. 255 ] characters ^[0-9A-Z_]+$ Mandate enforcement for the network.
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
network_rules | Array of strings [ 1 .. 100 ] items Specific rules associated with Network. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
name | string (List of network names) [ 1 .. 255 ] characters ^[0-9A-Z_]+$ The capability Network.
|
{- "preferred": true,
- "cross_border_transaction_supported": true,
- "supported_currencies": [
- "str"
], - "transfer_type": "WIRE",
- "mandate_enforcement": "SEPA",
- "network_rules": [
- "string"
], - "name": "ACCEL"
}
Object for exchange currency pricing details.
price_category_code | string [ 1 .. 32 ] characters ^[0-9A-Z]+$ Deprecated. Please use: ../user_profile/price_category. The price negotiation identifier with Paypal. |
legal_country_code | string <ppaas_common_country_code_v2> (country_code) = 2 characters ^([A-Z]{2}|C2)$ Deprecated. Please use: ../user_profile/legal_country_code. The legal country code to which the exchange is associated with. |
{- "price_category_code": "string",
- "legal_country_code": "string"
}
The Operation.
The Operation.
Enum Value | Description |
---|---|
CAPABILITY_OP_SINK | CAPABILITY_OP_SINK. |
CAPABILITY_OP_SOURCE | CAPABILITY_OP_SOURCE. |
CAPABILITY_OP_READ | CAPABILITY_OP_READ. |
READ | READ. |
SINK | SINK. |
SOURCE | SOURCE. |
"CAPABILITY_OP_SINK"
The JSON patch object to apply partial updates to resources.
op required | string The operation.
| ||||||||||||||||||||||||||
path | string The JSON Pointer to the target document location at which to complete the operation. | ||||||||||||||||||||||||||
value | any (Patch Value) The value to apply. The | ||||||||||||||||||||||||||
from | string The JSON Pointer to the target document location from which to move the value. Required for the |
{- "op": "add",
- "path": "string",
- "value": null,
- "from": "string"
}
Legal entity of PayPal.
Legal entity of PayPal.
Enum Value | Description |
---|---|
LEGAL_ENTITY_PAYPAL_INC | PayPal Inc. (US). |
LEGAL_ENTITY_PAYPAL_PRIVATE_LTD | PayPal Private LTD. |
LEGAL_ENTITY_PAYPAL_EUROPE | PayPal Europe. |
LEGAL_ENTITY_PAYPAL_CANADA | PayPal Canada. |
LEGAL_ENTITY_PAYPAL_TURKEY | PayPal Turkey |
LEGAL_ENTITY_PAYPAL_RUSSIA | PayPal Russia. |
LEGAL_ENTITY_PAYPAL_BRAZIL | PayPal Brazil. |
LEGAL_ENTITY_PAYPAL_MEXICO | PayPal Mexico. |
LEGAL_ENTITY_PAYPAL_INDIA | PayPal India. |
LEGAL_ENTITY_PAYPAL_AUSTRALIA | PayPal Australia. |
INC | PayPal Inc. (US). |
PVT_LTD | PayPal Private LTD. |
EUROPE | PayPal Europe. |
CANADA | PayPal Canada. |
TURKEY | PayPal Turkey |
RUSSIA | PayPal Russia. |
BRAZIL | PayPal Brazil. |
MEXICO | PayPal Mexico. |
INDIA | PayPal India. |
AUSTRALIA | PayPal Australia. |
"LEGAL_ENTITY_PAYPAL_INC"
The percentage, as a fixed-point, signed decimal number. For example, define a 19.99% interest rate as 19.99
.
The percentage, as a fixed-point, signed decimal number. For example, define a 19.99% interest rate as 19.99
.
"string"
The phone number, in its canonical international E.164 numbering plan format.
country_code required | string [ 1 .. 3 ] characters ^[0-9]{1,3}?$ The country calling code (CC), in its canonical international E.164 numbering plan format. The combined length of the CC and the national number must not be greater than 15 digits. The national number consists of a national destination code (NDC) and subscriber number (SN). |
national_number required | string [ 1 .. 14 ] characters ^[0-9]{1,14}?$ The national number, in its canonical international E.164 numbering plan format. The combined length of the country calling code (CC) and the national number must not be greater than 15 digits. The national number consists of a national destination code (NDC) and subscriber number (SN). |
extension_number | string [ 1 .. 15 ] characters ^[0-9]{1,15}?$ The extension number. |
{- "country_code": "str",
- "national_number": "string",
- "extension_number": "string"
}
Type of the phone and phone number.
phone_type | string (Phone Type) The phone usage type, for example, work, home, or mobile. |
object (Phone) The phone number. |
{- "phone_type": "FAX",
- "phone_number": {
- "country_code": "str",
- "national_number": "string",
- "extension_number": "string"
}
}
The phone type.
The phone type.
"FAX"
The portable international postal address. Maps to AddressValidationMetadata and HTML 5.1 Autofilling form controls: the autocomplete attribute.
address_line_1 | string <= 300 characters The first line of the address. For example, number or street. For example, |
address_line_2 | string <= 300 characters The second line of the address. For example, suite or apartment number. |
address_line_3 | string <= 100 characters The third line of the address, if needed. For example, a street complement for Brazil, direction text, such as |
admin_area_4 | string <= 100 characters The neighborhood, ward, or district. Smaller than
|
admin_area_3 | string <= 100 characters A sub-locality, suburb, neighborhood, or district. Smaller than
|
admin_area_2 | string <= 120 characters A city, town, or village. Smaller than |
admin_area_1 | string <= 300 characters The highest level sub-division in a country, which is usually a province, state, or ISO-3166-2 subdivision. Format for postal delivery. For example,
|
postal_code | string <= 60 characters The postal code, which is the zip code or equivalent. Typically required for countries with a postal code or an equivalent. See postal code. |
country_code required | string <ppaas_common_country_code_v2> (country_code) = 2 characters ^([A-Z]{2}|C2)$ The two-character ISO 3166-1 code that identifies the country or region. Note: The country code for Great Britain is |
object (Address Details) The non-portable additional address details that are sometimes needed for compliance, risk, or other scenarios where fine-grain address information might be needed. Not portable with common third party and open source. Redundant with core fields. |
{- "address_line_1": "string",
- "address_line_2": "string",
- "address_line_3": "string",
- "admin_area_4": "string",
- "admin_area_3": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st",
- "address_details": {
- "street_number": "string",
- "street_name": "string",
- "street_type": "string",
- "delivery_service": "string",
- "building_name": "string",
- "sub_building": "string"
}
}
Transaction Level Tags interpreted by Pricing.
Transaction Level Tags interpreted by Pricing.
Enum Value | Description |
---|---|
GROSS_BILLING | Gross billed price. |
FEE_APPLICABLE | Fee is applicable to the transaction. |
FEE_NOT_APPLICABLE | Fee is not applicable to the transaction. |
ALLOW_FEE_TO_EXCEED_TXN_AMOUNT | Fee is allowed to exceed transaction amount. |
PARTNER_SPECIFIC_TRANSACTION | Partner specific transaction. |
TAX_PRESENT_IN_TRANSACTION | Tax is included in transaction fee. |
COST_PRESENT_IN_TRANSACTION | There is cost for transaction. |
CROSS_BORDER | Cross border transaction. |
APPLIED_FEE_CAP | Fee cap is applied to the transaction. |
CROSS_BORDER_FEES_APPLIED | Cross border fee is applied to the transaction. |
CUSTOM_ROUNDING | Custom rounding preference or config is applied. |
COUNTRY_ADJ_APPLIED_DUE_TO_FALLBACK | Due to fallback, the country level adjustment got applied to the transaction. |
GLOBAL_PAY_LATER | Global pay later. |
"GROSS_BILLING"
List of rate refresh details having the epoch elapsed time and timezone based on merchant preference.
rate_refresh_time required | string <ppaas_common_time_duration_v2> (Time Duration) ^P([0-9]+Y)?([0-9]+M)?([0-9]+W)?([0-9]+D)?(T(... Duration when the rate will be refreshed based on the recurrence_period in UTC. |
rate_refresh_timezone required | string <ppaas_time_zone_v3> (time_zone) [ 1 .. 127 ] characters Timezone of the rate_refresh_time based on merchant preference. The service handle conversion to UTC. |
{- "rate_refresh_time": "string",
- "rate_refresh_timezone": "string"
}
Represents the operation status.
Represents the operation status.
Enum Value | Description |
---|---|
APPROVED | Represents the approved status. |
PENDING_APPROVAL | Represents the pending status. |
"APPROVED"
Request object for exchange rate quote.
base_amount | string [ 1 .. 32 ] characters ^([0-9]+[.][0-9]+)$ Product price in base currency. If not provided, PayPal returns only the exchange rate and does not calculate the |
fx_id | string [ 1 .. 4000 ] characters ^[ -~]+$ Unique identifier that links a quoted FX rate to an order. |
base_currency | string <ppaas_common_currency_code_v2> (currency_code) = 3 characters The currency code of the base amount to be converted for the presentment and in which the final transaction amount needs to be settled into merchant PayPal business account. This could be your primary currency, or any other PayPal supported holding currency. You can find currency codes here. |
quote_currency | string <ppaas_common_currency_code_v2> (currency_code) = 3 characters The currency code in which the conversion should take place using this API. This is the currency in which the transaction is performed, and the transaction amount gets converted into base currency. |
markup_percent | string <ppaas_common_percentage_v2> (percentage) ^((-?[0-9]+)|(-?([0-9]+)?[.][0-9]+))$ The percentage of the merchant or partner spread to be included as part of the exchange rate. markup_percent can range from 0 to 100. |
{- "base_amount": "string",
- "fx_id": "string",
- "base_currency": "str",
- "quote_currency": "str",
- "markup_percent": "string"
}
Request Object for quoting exchange rates.
organization | string [ 2 .. 100 ] characters ^\w{2,20}(\/\w{2,20})*$ Organization this managed account belongs to, in the partner's hierarchy, in the form of a path. |
required | Array of objects (Request object for exchange rate quote.) [ 1 .. 250 ] items Parameters required to request an exchange rate, passed in the quote_items array:
|
{- "organization": "string",
- "quote_items": [
- {
- "base_amount": "string",
- "fx_id": "string",
- "base_currency": "str",
- "quote_currency": "str",
- "markup_percent": "string"
}
]
}
Exchange rate details, specified as an object with the following parameters:
exchange_rate required | string [ 1 .. 32 ] characters ^([0-9]+[.][0-9]+)$ Conversion rate between the base and quote currencies. Includes markup if |
fx_id | string [ 1 .. 4000 ] characters ^[ -~]+$ Unique identifier that links a quoted FX rate to an order. Must be passed in further API calls. |
required | object (Money) The amount that needs to be converted. If this parameter was not passed in the request, the value of base_amount is considered as 1 by default. |
required | object (Money) The amount in desired currency after conversion. |
expiry_time | string <ppaas_date_time_v3> (date_time) [ 20 .. 64 ] characters ^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|... The time until exchange_rate will be valid for settlement. It is represented in ISO 8601. The time is determined at the time of contract agreement. |
rate_refresh_time | string <ppaas_date_time_v3> (date_time) [ 20 .. 64 ] characters ^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|... The time at which new exchange rates will be available next for this currency pair. The frequency is determined at the time of contract agreement. |
update_time | string <ppaas_date_time_v3> (date_time) [ 20 .. 64 ] characters ^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|... The time at which the exchange rate was last updated. The time is represented in ISO 8601. |
{- "exchange_rate": "string",
- "fx_id": "string",
- "base_amount": {
- "currency_code": "str",
- "value": "string"
}, - "quote_amount": {
- "currency_code": "str",
- "value": "string"
}, - "expiry_time": "stringstringstringst",
- "rate_refresh_time": "stringstringstringst",
- "update_time": "string"
}
Response Object for quoting exchange rates.
required | Array of objects (Response object for fx service exchange currency.) [ 1 .. 500 ] items Exchange rate details, specified as an array of object. |
{- "exchange_rate_quotes": [
- {
- "exchange_rate": "string",
- "fx_id": "string",
- "base_amount": {
- "currency_code": "str",
- "value": "string"
}, - "quote_amount": {
- "currency_code": "str",
- "value": "string"
}, - "expiry_time": "stringstringstringst",
- "rate_refresh_time": "stringstringstringst",
- "update_time": "string"
}
]
}
Status of the instrument, indicates whether it is available for clients.
Status of the instrument, indicates whether it is available for clients.
Enum Value | Description |
---|---|
OPEN | Status of the instrument - OPEN. Instrument is available for transactions. |
CLOSED | Status of the instrument - CLOSED. Instrument is unavailable for transactions. |
"OPEN"
Sub balance resource.
type | string (The specific type of the balance account) [ 1 .. 255 ] characters ^[0-9A-Z_]+$ Type of balance.
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||
object (Money) Amount along with currency of balance account. |
{- "type": "AVAILABLE",
- "amount": {
- "currency_code": "str",
- "value": "string"
}
}
The specific type of the balance account.
The specific type of the balance account.
Enum Value | Description |
---|---|
AVAILABLE | Available balance. |
CC_FUNDED | Amount received from credit card transactions. |
EXIT_LIMIT | Exit Limit. |
EXTERNAL_HOLD | External hold. |
GIFT_CARD | Gift card balance. |
GUEST_BALANCE | Guest balance for temporary usage like PUI and PAD. |
HOLD | Hold balance because of risk. |
LIMITATION_RESERVE | Reserve balance due to limitations. |
MERCHANT_SPECIFIC_BALANCE | Payable or receivable balance aka MSB. |
PENDING_REVERSAL | Buffer balance kept for pending reversals. |
TOTAL_BALANCE | Total balance, includes holds, reserves and balance. |
VARIABLE_RESERVES | Reserve balance. |
DELAYED_SETTLEMENT | Delayed settlement. |
EBAY_NON_PERFORMER | EBay non performer. |
JUMP_START | Jump start. |
MINIMUM_BALANCE | Minimum balance. |
MPLT_HOLD | Transaction hold on seller's account. |
TRANS_LEVEL_HOLD | Transaction hold which is placed when buyer is fraudulent. |
AUTHORIZED_EXTERNAL_UNCLEARED_FUNDS | Authorized external uncleared funds. |
DYNAMIC_HOLD | Transaction hold to mitigate fraud due to insufficient funds on outstanding transaction. |
UNCLEARED_FUNDS | Disbursement to Balance should be UNCLEARED_FUNDS when funding source is ECHECK. |
TAX_HOLD | Transaction hold when tax identifier information is not available. |
USER_CONSENT_HOLD | Transaction hold when user has not consented on the latest terms and conditions available. |
PARTNER_LOSS_BALANCE | Holds the partner loss amount. |
PROGRESSIVE_KYC_HOLD | Hold type to park merchant balance which are onboarded under progressive onboarding and hold will be released once KYC is completed. |
CHARGE_OFF_BALANCE | To hold the locked charge off amount. |
"AVAILABLE"
The ISO-8601-formatted length of time in years, months, weeks, days, hours, minutes, and seconds.
Note: The format isPyYmMdDThHmMsS
. When an amount is zero, you can omit it. Because week cannot co-exist with other time components in ISO-8601 duration, specifyP7D
. Make provisions to incorporate the effects of daylight savings time.
The ISO-8601-formatted length of time in years, months, weeks, days, hours, minutes, and seconds.
Note: The format isPyYmMdDThHmMsS
. When an amount is zero, you can omit it. Because week cannot co-exist with other time components in ISO-8601 duration, specifyP7D
. Make provisions to incorporate the effects of daylight savings time.
"string"
The time zone, in Internet Assigned Numbers Authority (IANA) time zone (tz) database format. A valid value is America/New_York
or Etc/UTC
. Do not use ambiguous, non-qualified tz database values, such as EST
or GB
. Before you include this type in your interface, consider whether it is appropriate to convey time zone information with your type. At the time of display to the user, transform this value from UTC. Typically, this type is associated with user-preference APIs.
The time zone, in Internet Assigned Numbers Authority (IANA) time zone (tz) database format. A valid value is America/New_York
or Etc/UTC
. Do not use ambiguous, non-qualified tz database values, such as EST
or GB
. Before you include this type in your interface, consider whether it is appropriate to convey time zone information with your type. At the time of display to the user, transform this value from UTC. Typically, this type is associated with user-preference APIs.
"string"