Authorize payment for order

Authorizes payment for an order. To successfully authorize payment for an order, the buyer must first approve the order or a valid payment_source must be provided in the request. A buyer can approve the order upon being redirected to the rel:approve URL that was returned in the HATEOAS links in the create order response.

Authorization

AuthorizationBearer <token>

FlowClient CredentialsToken URLhttps://api-m.sandbox.paypal.com/v1/oauth2/tokenInheader

Scopes

Manage payments and checkout workflow.https://uri.paypal.com/services/payments/payment
Allows client-side integration on Create, Get, Patch, Authorize & Capture Order endpoints.https://uri.paypal.com/services/payments/orders/deprecating-jssdk-migration-for-limited-merchants

Path Parameters

Header Parameters

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

payment_sourceobject<payment_source>Optional

The payment source definition.

payment_source properties

16 properties

cardobject<card_request>Optional

The payment card to use to fund a payment. Can be a credit or debit card.

card_request properties

13 properties

namestringOptional

The card holder's name as it appears on the card.

Match^.{1,300}$Length1 <= length <= 300

numberstringOptional

The primary account number (PAN) for the payment card.

Match^[0-9]{13,19}$Length13 <= length <= 19

expirystring<date_year_month>Optional

The year and month, in ISO-8601 `YYYY-MM` date format. See [Internet date and time format](https://tools.ietf.org/html/rfc3339#section-5.6).

Match^[0-9]{4}-(0[1-9]|1[0-2])$Length7 <= length <= 7

security_codestringOptional

The three- or four-digit security code of the card. Also known as the CVV, CVC, CVN, CVE, or CID. This parameter cannot be present in the request when `payment_initiator=MERCHANT`.

Match^[0-9]{3,4}$Length3 <= length <= 4

typeenum<card_type>Optional

Type of card. i.e Credit, Debit and so on.

Allowed values

"CREDIT"
"DEBIT"
"PREPAID"
"STORE"
"UNKNOWN"

brandenum<card_brand>Optional

The card network or brand. Applies to credit, debit, gift, and payment cards.

Allowed values

"VISA"
"MASTERCARD"
"DISCOVER"
"AMEX"
"SOLO"
"JCB"
"STAR"
"DELTA"
"SWITCH"
"MAESTRO"
"CB_NATIONALE"
"CONFIGOGA"

billing_addressobject<address_portable>Optional

The portable international postal address. Maps to [AddressValidationMetadata](https://github.com/googlei18n/libaddressinput/wiki/AddressValidationMetadata) and HTML 5.1 [Autofilling form controls: the autocomplete attribute](https://www.w3.org/TR/html51/sec-forms.html#autofilling-form-controls-the-autocomplete-attribute).

address_portable properties

10 properties

address_line_1stringOptional

The first line of the address, such as number and street, for example, `173 Drury Lane`. Needed for data entry, and Compliance and Risk checks. This field needs to pass the full address.

Match^[\S\s]*$Length0 <= length <= 300

address_line_2stringOptional

The second line of the address, for example, a suite or apartment number.

Match^[\S\s]*$Length0 <= length <= 300

address_line_3stringOptional

The third line of the address, if needed. Examples include a street complement for Brazil, direction text, such as `next to Walmart`, or a landmark in an Indian address.

Match^[\S\s]*$Length0 <= length <= 100

admin_area_4stringOptional

The neighborhood, ward, or district. This is smaller than `admin_area_level_3` or `sub_locality`. Value is:

The postal sorting code that is used in Guernsey and many French territories, such as French Guiana.
The fine-grained administrative levels in China.

Match^[\S\s]*$Length0 <= length <= 100

admin_area_3stringOptional

The sub-locality, suburb, neighborhood, or district. This is smaller than `admin_area_level_2`. Value is:

Brazil. Suburb, *bairro*, or neighborhood.
India. Sub-locality or district. Street name information isn't always available, but a sub-locality or district can be a very small area.

Match^[\S\s]*$Length0 <= length <= 100

admin_area_2stringOptional

A city, town, or village. Smaller than `admin_area_level_1`.

Match^[\S\s]*$Length0 <= length <= 120

admin_area_1stringOptional

The highest-level sub-division in a country, which is usually a province, state, or ISO-3166-2 subdivision. This data is formatted for postal delivery, for example, `CA` and not `California`. Value, by country, is:

UK. A county.
US. A state.
Canada. A province.
Japan. A prefecture.
Switzerland. A *kanton*.

Match^[\S\s]*$Length0 <= length <= 300

postal_codestringOptional

The postal code, which is the ZIP code or equivalent. Typically required for countries with a postal code or an equivalent. See [postal code](https://en.wikipedia.org/wiki/Postal_code).

Match^[\S\s]*$Length0 <= length <= 60

country_codestring<country_code>Required

The [2-character ISO 3166-1 code](/api/rest/reference/country-codes/) that identifies the country or region.

Match^([A-Z]{2}|C2)$Length2 <= length <= 2

address_detailsobject<Address Details>Optional

The non-portable additional address details include fine-grain address information for Compliance, Risk, and other scenarios. This isn't portable with common third-party and open source applications. This can include data that is redundant with core fields. For example, `address_portable.address_line_1` is usually a combination of `address_details.street_number`, `street_name`, and `street_type`.

attributesobject<card_attributes>Optional

Additional attributes associated with the use of this card.

vault_idstring<vault_id>Optional

The PayPal-generated ID for the vaulted payment source. This ID should be stored on the merchant's server so the saved payment source can be used for future transactions.

Match^[0-9a-zA-Z_-]+$Length1 <= length <= 255

single_use_tokenstring<single_use_token>Optional

The PayPal-generated, short-lived, one-time-use token, used to communicate payment information to PayPal for transaction processing.

Match^[0-9a-zA-Z_-]+$Length1 <= length <= 255

stored_credentialobject<card_stored_credential>Optional

Provides additional details to process a payment using a `card` that has been stored or is intended to be stored (also referred to as stored_credential or card-on-file).
Parameter compatibility:

`payment_type=ONE_TIME` is compatible only with `payment_initiator=CUSTOMER`.
`usage=FIRST` is compatible only with `payment_initiator=CUSTOMER`.
`previous_transaction_reference` or `previous_network_transaction_reference` is compatible only with `payment_initiator=MERCHANT`.
Only one of the parameters - `previous_transaction_reference` and `previous_network_transaction_reference` - can be present in the request.

card_stored_credential properties

4 properties

payment_initiatorenum<payment_initiator>Required

The person or party who initiated or triggered the payment.

Allowed values

"CUSTOMER"
"MERCHANT"

payment_typeenum<stored_payment_source_payment_type>Required

Indicates the type of the stored payment_source payment.

Allowed values

"ONE_TIME"
"RECURRING"
"UNSCHEDULED"

usageenum<stored_payment_source_usage_type>Optional

Indicates if this is a `first` or `subsequent` payment using a stored payment source (also referred to as stored credential or card on file).

Allowed values

"FIRST"
"SUBSEQUENT"
"DERIVED"Default

previous_network_transaction_referenceobject<network_transaction_reference>Optional

Reference values used by the card network to identify a transaction.

network_tokenobject<network_token_request>Optional

The Third Party Network token used to fund a payment.

experience_contextobject<card_experience_context>Optional

Customizes the payer experience during the 3DS Approval for payment.

tokenobject<token>Optional

The tokenized payment source to fund a payment.

paypalobject<paypal_wallet>Optional

A resource that identifies a PayPal Wallet is used for payment.

paypal_wallet properties

11 properties

vault_idstring<vault_id>Optional

The PayPal-generated ID for the vaulted payment source. This ID should be stored on the merchant's server so the saved payment source can be used for future transactions.

Match^[0-9a-zA-Z_-]+$Length1 <= length <= 255

email_addressstring<email>Optional

The internationalized email address.

Match^.*(?:[a-zA-Z0-9!#$%&'*+/=?^_`{|}~-]+(?:\.[a-zA-Z0-9!#$%&'*+/=?^_`{|}~-]+)*|(?:[\x01-\x08\x0b\x0c\x0e-\x1f\x21\x23-\x5b\x5d-\x7f]|\[\x01-\x09\x0b\x0c\x0e-\x7f])*")@(?:(?:[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?\.)+[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?|\[(?:(?:(2(5[0-5]|[0-4][0-9])|1[0-9][0-9]|[1-9]?[0-9]))\.){3}(?:(2(5[0-5]|[0-4][0-9])|1[0-9][0-9]|[1-9]?[0-9])|[a-zA-Z0-9-]*[a-zA-Z0-9]:(?:[\x01-\x08\x0b\x0c\x0e-\x1f\x21-\x5a\x53-\x7f]|\[\x01-\x09\x0b\x0c\x0e-\x7f])+)\]).*$Length3 <= length <= 254

nameobject<name>Optional

The name of the party.

phoneobject<phone_with_type>Optional

The phone information.

birth_datestring<date_no_time>Optional

The stand-alone date, in [Internet date and time format](https://tools.ietf.org/html/rfc3339#section-5.6). To represent special legal values, such as a date of birth, you should use dates with no associated time or time-zone data. Whenever possible, use the standard `date_time` type. This regular expression does not validate all dates. For example, February 31 is valid and nothing is known about leap years.

Match^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|3[0-1])$Length10 <= length <= 10

tax_infoobject<tax_info>Optional

The tax ID of the customer. The customer is also known as the payer. Both `tax_id` and `tax_id_type` are required.

addressobject<address_portable>Optional

address_portable properties

10 properties

address_line_1stringOptional

The first line of the address, such as number and street, for example, `173 Drury Lane`. Needed for data entry, and Compliance and Risk checks. This field needs to pass the full address.

Match^[\S\s]*$Length0 <= length <= 300

address_line_2stringOptional

The second line of the address, for example, a suite or apartment number.

Match^[\S\s]*$Length0 <= length <= 300

address_line_3stringOptional

The third line of the address, if needed. Examples include a street complement for Brazil, direction text, such as `next to Walmart`, or a landmark in an Indian address.

Match^[\S\s]*$Length0 <= length <= 100

admin_area_4stringOptional

The neighborhood, ward, or district. This is smaller than `admin_area_level_3` or `sub_locality`. Value is:

The postal sorting code that is used in Guernsey and many French territories, such as French Guiana.
The fine-grained administrative levels in China.

Match^[\S\s]*$Length0 <= length <= 100

admin_area_3stringOptional

The sub-locality, suburb, neighborhood, or district. This is smaller than `admin_area_level_2`. Value is:

Brazil. Suburb, *bairro*, or neighborhood.
India. Sub-locality or district. Street name information isn't always available, but a sub-locality or district can be a very small area.

Match^[\S\s]*$Length0 <= length <= 100

admin_area_2stringOptional

A city, town, or village. Smaller than `admin_area_level_1`.

Match^[\S\s]*$Length0 <= length <= 120

admin_area_1stringOptional

UK. A county.
US. A state.
Canada. A province.
Japan. A prefecture.
Switzerland. A *kanton*.

Match^[\S\s]*$Length0 <= length <= 300

postal_codestringOptional

The postal code, which is the ZIP code or equivalent. Typically required for countries with a postal code or an equivalent. See [postal code](https://en.wikipedia.org/wiki/Postal_code).

Match^[\S\s]*$Length0 <= length <= 60

country_codestring<country_code>Required

The [2-character ISO 3166-1 code](/api/rest/reference/country-codes/) that identifies the country or region.

Match^([A-Z]{2}|C2)$Length2 <= length <= 2

address_detailsobject<Address Details>Optional

attributesobject<paypal_wallet_attributes>Optional

Additional attributes associated with the use of this PayPal Wallet.

experience_contextobject<paypal_wallet_experience_context>Optional

Customizes the payer experience during the approval process for payment with PayPal.

paypal_wallet_experience_context properties

11 properties

brand_namestringOptional

The label that overrides the business name in the PayPal account on the PayPal site. The pattern is defined by an external party and supports Unicode.

Match^.*$Length1 <= length <= 127

localestring<language>Optional

The [language tag](https://tools.ietf.org/html/bcp47#section-2) for the language in which to localize the error-related strings, such as messages, issues, and suggested actions. The tag is made up of the [ISO 639-2 language code](https://www.loc.gov/standards/iso639-2/php/code_list.php), the optional [ISO-15924 script tag](https://www.unicode.org/iso15924/codelists.html), and the [ISO-3166 alpha-2 country code](/api/rest/reference/country-codes/) or [M49 region code](https://unstats.un.org/unsd/methodology/m49/).

Match^[a-z]{2}(?:-[A-Z][a-z]{3})?(?:-(?:[A-Z]{2}|[0-9]{3}))?$Length2 <= length <= 10

shipping_preferenceenumOptional

The location from which the shipping address is derived.

Allowed values

"GET_FROM_FILE"Default
"NO_SHIPPING"
"SET_PROVIDED_ADDRESS"

contact_preferenceenumOptional

The preference to display the contact information (buyer’s shipping email & phone number) on PayPal's checkout for easy merchant-buyer communication.

Allowed values

"NO_CONTACT_INFO"Default
"UPDATE_CONTACT_INFO"
"RETAIN_CONTACT_INFO"

return_urlstring<url>Optional

Describes the URL.

FormaturiLength0 <= length <= 2147483647

cancel_urlstring<url>Optional

Describes the URL.

FormaturiLength0 <= length <= 2147483647

app_switch_contextobject<app_switch_context>Optional

Merchant provided details of the native app or mobile web browser to facilitate buyer's app switch to the PayPal consumer app.

landing_pageenumOptional

The type of landing page to show on the PayPal site for customer checkout.

Allowed values

"LOGIN"
"GUEST_CHECKOUT"
"NO_PREFERENCE"Default
"BILLING"

user_actionenumOptional

Configures a Continue or Pay Now checkout flow.

Allowed values

"CONTINUE"Default
"PAY_NOW"

payment_method_preferenceenumOptional

The merchant-preferred payment methods.

Allowed values

"UNRESTRICTED"Default
"IMMEDIATE_PAYMENT_REQUIRED"

order_update_callback_configobject<callback_configuration>Optional

CallBack Configuration that the merchant can provide to PayPal/Venmo.

billing_agreement_idstring<billing_agreement_id>Optional

The PayPal billing agreement ID. References an approved recurring payment for goods or services.

Match^[a-zA-Z0-9-]+$Length2 <= length <= 128

stored_credentialobject<paypal_wallet_stored_credential>Optional

Provides additional details to process a payment using the PayPal wallet billing agreement or a vaulted payment method that has been stored or is intended to be stored.

paypal_wallet_stored_credential properties

4 properties

payment_initiatorenum<payment_initiator>Required

The person or party who initiated or triggered the payment.

Allowed values

"CUSTOMER"
"MERCHANT"

charge_patternenum<charge_pattern>OptionalDeprecated

DEPRECATED. Expected business/pricing model for the billing agreement, Please use usage_pattern instead. DEPRECATED

See
usage_pattern

Expected business/pricing model for the billing agreement.

Allowed values

"IMMEDIATE"
"DEFERRED"
"RECURRING_PREPAID"
"RECURRING_POSTPAID"
"THRESHOLD_PREPAID"
"THRESHOLD_POSTPAID"
"SUBSCRIPTION_PREPAID"
"SUBSCRIPTION_POSTPAID"
"UNSCHEDULED_PREPAID"
"UNSCHEDULED_POSTPAID"
"INSTALLMENT_PREPAID"
"INSTALLMENT_POSTPAID"

usage_patternenum<charge_pattern>Optional

Expected business/pricing model for the billing agreement.

Allowed values

"IMMEDIATE"
"DEFERRED"
"RECURRING_PREPAID"
"RECURRING_POSTPAID"
"THRESHOLD_PREPAID"
"THRESHOLD_POSTPAID"
"SUBSCRIPTION_PREPAID"
"SUBSCRIPTION_POSTPAID"
"UNSCHEDULED_PREPAID"
"UNSCHEDULED_POSTPAID"
"INSTALLMENT_PREPAID"
"INSTALLMENT_POSTPAID"

usageenum<stored_payment_source_usage_type>Optional

Indicates if this is a `first` or `subsequent` payment using a stored payment source (also referred to as stored credential or card on file).

Allowed values

"FIRST"
"SUBSEQUENT"
"DERIVED"Default

bancontactobject<bancontact_request>Optional

Information needed to pay using Bancontact.

bancontact_request properties

3 properties

namestring<full_name>Required

The full name representation like Mr J Smith.

Match^[\S\s]*$Length3 <= length <= 300

country_codestring<country_code-2>Required

The [two-character ISO 3166-1 code](/api/rest/reference/country-codes/) that identifies the country or region.

Match^([A-Z]{2}|C2)$Length2 <= length <= 2

experience_contextobject<experience_context_base>Optional

Customizes the payer experience during the approval process for the payment.

blikobject<blik_request>Optional

Information needed to pay using BLIK.

blik_request properties

6 properties

namestring<full_name>Required

The full name representation like Mr J Smith.

Match^[\S\s]*$Length3 <= length <= 300

country_codestring<country_code-2>Required

The [two-character ISO 3166-1 code](/api/rest/reference/country-codes/) that identifies the country or region.

Match^([A-Z]{2}|C2)$Length2 <= length <= 2

emailstring<email_address>Optional

The internationalized email address.

Match^(?:[A-Za-z0-9!#$%&'*+/=?^_`{|}~-]+(?:\.[A-Za-z0-9!#$%&'*+/=?^_`{|}~-]+)*|"(?:[\x01-\x08\x0b\x0c\x0e-\x1f\x21\x23-\x5b\x5d-\x7f]|\\[\x01-\x09\x0b\x0c\x0e-\x7f])*")@(?:(?:[A-Za-z0-9](?:[A-Za-z0-9-]*[A-Za-z0-9])?\.)+[A-Za-z0-9](?:[A-Za-z0-9-]*[A-Za-z0-9])?|\[(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?|[A-Za-z0-9-]*[A-Za-z0-9]:(?:[\x01-\x08\x0b\x0c\x0e-\x1f\x21-\x5a\x53-\x7f]|\\[\x01-\x09\x0b\x0c\x0e-\x7f])+)\])$Length3 <= length <= 254

experience_contextobject<blik_experience_context>Optional

Customizes the payer experience during the approval process for the BLIK payment.

blik_experience_context properties

7 properties

brand_namestringOptional

The label that overrides the business name in the PayPal account on the PayPal site. The pattern is defined by an external party and supports Unicode.

Match^.*$Length1 <= length <= 127

localestring<language>Optional

Match^[a-z]{2}(?:-[A-Z][a-z]{3})?(?:-(?:[A-Z]{2}|[0-9]{3}))?$Length2 <= length <= 10

shipping_preferenceenumOptional

The location from which the shipping address is derived.

Allowed values

"GET_FROM_FILE"Default
"NO_SHIPPING"
"SET_PROVIDED_ADDRESS"

return_urlstring<url>Optional

Describes the URL.

FormaturiLength0 <= length <= 2147483647

cancel_urlstring<url>Optional

Describes the URL.

FormaturiLength0 <= length <= 2147483647

consumer_ipstring<ip_address>Optional

An Internet Protocol address (IP address). This address assigns a numerical label to each device that is connected to a computer network through the Internet Protocol. Supports IPv4 and IPv6 addresses.

Match^(([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])$|^(([a-zA-Z]|[a-zA-Z][a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z]|[A-Za-z][A-Za-z0-9\-]*[A-Za-z0-9])$|^\s*((([0-9A-Fa-f]{1,4}:){7}([0-9A-Fa-f]{1,4}|:))|(([0-9A-Fa-f]{1,4}:){6}(:[0-9A-Fa-f]{1,4}|((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3})|:))|(([0-9A-Fa-f]{1,4}:){5}(((:[0-9A-Fa-f]{1,4}){1,2})|:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3})|:))|(([0-9A-Fa-f]{1,4}:){4}(((:[0-9A-Fa-f]{1,4}){1,3})|((:[0-9A-Fa-f]{1,4})?:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:))|(([0-9A-Fa-f]{1,4}:){3}(((:[0-9A-Fa-f]{1,4}){1,4})|((:[0-9A-Fa-f]{1,4}){0,2}:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:))|(([0-9A-Fa-f]{1,4}:){2}(((:[0-9A-Fa-f]{1,4}){1,5})|((:[0-9A-Fa-f]{1,4}){0,3}:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:))|(([0-9A-Fa-f]{1,4}:){1}(((:[0-9A-Fa-f]{1,4}){1,6})|((:[0-9A-Fa-f]{1,4}){0,4}:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:))|(:(((:[0-9A-Fa-f]{1,4}){1,7})|((:[0-9A-Fa-f]{1,4}){0,5}:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:)))(%.+)?\s*$Length7 <= length <= 39

consumer_user_agentstringOptional

The payer's User Agent. For example, Mozilla/5.0 (Macintosh; Intel Mac OS X x.y; rv:42.0).

Match^.*$Length1 <= length <= 256

level_0object<blik_seamless>Optional

Information used to pay using BLIK level_0 flow.

one_clickobject<blik_one_click>Optional

Information used to pay using BLIK one-click flow.

epsobject<eps_request>Optional

Information needed to pay using eps.

eps_request properties

3 properties

namestring<full_name>Required

The full name representation like Mr J Smith.

Match^[\S\s]*$Length3 <= length <= 300

country_codestring<country_code-2>Required

The [two-character ISO 3166-1 code](/api/rest/reference/country-codes/) that identifies the country or region.

Match^([A-Z]{2}|C2)$Length2 <= length <= 2

experience_contextobject<experience_context_base>Optional

Customizes the payer experience during the approval process for the payment.

giropayobject<giropay_request>Optional

Information needed to pay using giropay.

giropay_request properties

3 properties

namestring<full_name>Required

The full name representation like Mr J Smith.

Match^[\S\s]*$Length3 <= length <= 300

country_codestring<country_code-2>Required

The [two-character ISO 3166-1 code](/api/rest/reference/country-codes/) that identifies the country or region.

Match^([A-Z]{2}|C2)$Length2 <= length <= 2

experience_contextobject<experience_context_base>Optional

Customizes the payer experience during the approval process for the payment.

idealobject<ideal_request>Optional

Information needed to pay using iDEAL.

ideal_request properties

4 properties

namestring<full_name>Required

The full name representation like Mr J Smith.

Match^[\S\s]*$Length3 <= length <= 300

country_codestring<country_code-2>Required

The [two-character ISO 3166-1 code](/api/rest/reference/country-codes/) that identifies the country or region.

Match^([A-Z]{2}|C2)$Length2 <= length <= 2

bicstring<bic>Optional

The business identification code (BIC). In payments systems, a BIC is used to identify a specific business, most commonly a bank.

Match^[A-Z-a-z0-9]{4}[A-Z-a-z]{2}[A-Z-a-z0-9]{2}([A-Z-a-z0-9]{3})?$Length8 <= length <= 11

experience_contextobject<experience_context_base>Optional

Customizes the payer experience during the approval process for the payment.

mybankobject<mybank_request>Optional

Information needed to pay using MyBank.

mybank_request properties

3 properties

namestring<full_name>Required

The full name representation like Mr J Smith.

Match^[\S\s]*$Length3 <= length <= 300

country_codestring<country_code-2>Required

The [two-character ISO 3166-1 code](/api/rest/reference/country-codes/) that identifies the country or region.

Match^([A-Z]{2}|C2)$Length2 <= length <= 2

experience_contextobject<experience_context_base>Optional

Customizes the payer experience during the approval process for the payment.

p24object<p24_request>Optional

Information needed to pay using P24 (Przelewy24).

p24_request properties

4 properties

namestring<full_name>Required

The full name representation like Mr J Smith.

Match^[\S\s]*$Length3 <= length <= 300

emailstring<email_address>Required

The internationalized email address.

country_codestring<country_code-2>Required

The [two-character ISO 3166-1 code](/api/rest/reference/country-codes/) that identifies the country or region.

Match^([A-Z]{2}|C2)$Length2 <= length <= 2

experience_contextobject<experience_context_base>Optional

Customizes the payer experience during the approval process for the payment.

sofortobject<sofort_request>Optional

Information needed to pay using Sofort.

sofort_request properties

3 properties

namestring<full_name>Required

The full name representation like Mr J Smith.

Match^[\S\s]*$Length3 <= length <= 300

country_codestring<country_code-2>Required

The [two-character ISO 3166-1 code](/api/rest/reference/country-codes/) that identifies the country or region.

Match^([A-Z]{2}|C2)$Length2 <= length <= 2

experience_contextobject<experience_context_base>Optional

Customizes the payer experience during the approval process for the payment.

trustlyobject<trustly_request>Optional

Information needed to pay using Trustly.

trustly_request properties

4 properties

namestring<full_name>Required

The full name representation like Mr J Smith.

Match^[\S\s]*$Length3 <= length <= 300

country_codestring<country_code-2>Required

The [two-character ISO 3166-1 code](/api/rest/reference/country-codes/) that identifies the country or region.

Match^([A-Z]{2}|C2)$Length2 <= length <= 2

emailstring<email_address>Required

The internationalized email address.

experience_contextobject<experience_context_base>Optional

Customizes the payer experience during the approval process for the payment.

apple_payobject<apple_pay_request>Optional

Information needed to pay using ApplePay.

apple_pay_request properties

9 properties

idstringOptional

ApplePay transaction identifier, this will be the unique identifier for this transaction provided by Apple. The pattern is defined by an external party and supports Unicode.

Match^.*$Length1 <= length <= 250

namestring<full_name>Optional

The full name representation like Mr J Smith.

Match^[\S\s]*$Length3 <= length <= 300

email_addressstring<email_address>Optional

The internationalized email address.

phone_numberobject<phone_number_without_country_code>Optional

A structured representation of a phone number conforming to the international [E.164 numbering plan format](https://www.itu.int/rec/T-REC-E.164/en),requiring only the national_number field.

decrypted_tokenobject<apple_pay_decrypted_token_data>Optional

Information about the Payment data obtained by decrypting Apple Pay token.

apple_pay_decrypted_token_data properties

5 properties

transaction_amountobject<money>Optional

The currency and amount for a financial transaction, such as a balance or payment due.

tokenized_cardobject<card>Required

The payment card to use to fund a payment. Can be a credit or debit card.

card properties

8 properties

namestringOptional

The card holder's name as it appears on the card.

Match^.{1,300}$Length1 <= length <= 300

numberstringOptional

The primary account number (PAN) for the payment card.

Match^[0-9]{13,19}$Length13 <= length <= 19

expirystring<date_year_month>Optional

The year and month, in ISO-8601 `YYYY-MM` date format. See [Internet date and time format](https://tools.ietf.org/html/rfc3339#section-5.6).

Match^[0-9]{4}-(0[1-9]|1[0-2])$Length7 <= length <= 7

security_codestringOptional

The three- or four-digit security code of the card. Also known as the CVV, CVC, CVN, CVE, or CID. This parameter cannot be present in the request when `payment_initiator=MERCHANT`.

Match^[0-9]{3,4}$Length3 <= length <= 4

typeenum<card_type>Optional

Type of card. i.e Credit, Debit and so on.

Allowed values

"CREDIT"
"DEBIT"
"PREPAID"
"STORE"
"UNKNOWN"

brandenum<card_brand>Optional

The card network or brand. Applies to credit, debit, gift, and payment cards.

Allowed values

"VISA"
"MASTERCARD"
"DISCOVER"
"AMEX"
"SOLO"
"JCB"
"STAR"
"DELTA"
"SWITCH"
"MAESTRO"
"CB_NATIONALE"
"CONFIGOGA"

billing_addressobject<address_portable>Optional

address_portable properties

10 properties

address_line_1stringOptional

The first line of the address, such as number and street, for example, `173 Drury Lane`. Needed for data entry, and Compliance and Risk checks. This field needs to pass the full address.

Match^[\S\s]*$Length0 <= length <= 300

address_line_2stringOptional

The second line of the address, for example, a suite or apartment number.

Match^[\S\s]*$Length0 <= length <= 300

address_line_3stringOptional

The third line of the address, if needed. Examples include a street complement for Brazil, direction text, such as `next to Walmart`, or a landmark in an Indian address.

Match^[\S\s]*$Length0 <= length <= 100

admin_area_4stringOptional

The neighborhood, ward, or district. This is smaller than `admin_area_level_3` or `sub_locality`. Value is:

The postal sorting code that is used in Guernsey and many French territories, such as French Guiana.
The fine-grained administrative levels in China.

Match^[\S\s]*$Length0 <= length <= 100

admin_area_3stringOptional

The sub-locality, suburb, neighborhood, or district. This is smaller than `admin_area_level_2`. Value is:

Brazil. Suburb, *bairro*, or neighborhood.
India. Sub-locality or district. Street name information isn't always available, but a sub-locality or district can be a very small area.

Match^[\S\s]*$Length0 <= length <= 100

admin_area_2stringOptional

A city, town, or village. Smaller than `admin_area_level_1`.

Match^[\S\s]*$Length0 <= length <= 120

admin_area_1stringOptional

UK. A county.
US. A state.
Canada. A province.
Japan. A prefecture.
Switzerland. A *kanton*.

Match^[\S\s]*$Length0 <= length <= 300

postal_codestringOptional

The postal code, which is the ZIP code or equivalent. Typically required for countries with a postal code or an equivalent. See [postal code](https://en.wikipedia.org/wiki/Postal_code).

Match^[\S\s]*$Length0 <= length <= 60

country_codestring<country_code>Required

The [2-character ISO 3166-1 code](/api/rest/reference/country-codes/) that identifies the country or region.

Match^([A-Z]{2}|C2)$Length2 <= length <= 2

address_detailsobject<Address Details>Optional

attributesobject<card_attributes>Optional

Additional attributes associated with the use of this card.

device_manufacturer_idstringOptional

Apple Pay Hex-encoded device manufacturer identifier. The pattern is defined by an external party and supports Unicode.

Match^.*$Length1 <= length <= 2000

payment_data_typeenumOptional

Indicates the type of payment data passed, in case of Non China the payment data is 3DSECURE and for China it is EMV.

Allowed values

"3DSECURE"
"EMV"

payment_dataobject<apple_pay_payment_data>Optional

Information about the decrypted apple pay payment data for the token like cryptogram, eci indicator.

stored_credentialobject<card_stored_credential>Optional

Provides additional details to process a payment using a `card` that has been stored or is intended to be stored (also referred to as stored_credential or card-on-file).
Parameter compatibility:

`payment_type=ONE_TIME` is compatible only with `payment_initiator=CUSTOMER`.
`usage=FIRST` is compatible only with `payment_initiator=CUSTOMER`.
`previous_transaction_reference` or `previous_network_transaction_reference` is compatible only with `payment_initiator=MERCHANT`.
Only one of the parameters - `previous_transaction_reference` and `previous_network_transaction_reference` - can be present in the request.

card_stored_credential properties

4 properties

payment_initiatorenum<payment_initiator>Required

The person or party who initiated or triggered the payment.

Allowed values

"CUSTOMER"
"MERCHANT"

payment_typeenum<stored_payment_source_payment_type>Required

Indicates the type of the stored payment_source payment.

Allowed values

"ONE_TIME"
"RECURRING"
"UNSCHEDULED"

usageenum<stored_payment_source_usage_type>Optional

Indicates if this is a `first` or `subsequent` payment using a stored payment source (also referred to as stored credential or card on file).

Allowed values

"FIRST"
"SUBSEQUENT"
"DERIVED"Default

previous_network_transaction_referenceobject<network_transaction_reference>Optional

Reference values used by the card network to identify a transaction.

vault_idstring<vault_id>Optional

The PayPal-generated ID for the vaulted payment source. This ID should be stored on the merchant's server so the saved payment source can be used for future transactions.

Match^[0-9a-zA-Z_-]+$Length1 <= length <= 255

attributesobject<apple_pay_attributes>Optional

Additional attributes associated with apple pay.

experience_contextobject<apple_pay_experience_context>Optional

Customizes the payer experience during the approval process for the payment.

google_payobject<google_pay_request>Optional

Information needed to pay using Google Pay.

google_pay_request properties

7 properties

namestring<full_name>Optional

The full name representation like Mr J Smith.

Match^[\S\s]*$Length3 <= length <= 300

email_addressstring<email_address>Optional

The internationalized email address.

phone_numberobject<phone_number>Optional

A structured representation of a phone number conforming to the international [E.164 numbering plan format](https://www.itu.int/rec/T-REC-E.164/en),including both country_code and national_number fields.

cardobject<google_pay_card>Optional

The payment card used to fund a Google Pay payment. Can be a credit or debit card.

google_pay_card properties

6 properties

namestringOptional

The card holder's name as it appears on the card.

Match^.{1,300}$Length1 <= length <= 300

numberstringOptional

The primary account number (PAN) for the payment card.

Match^[0-9]{13,19}$Length13 <= length <= 19

expirystring<date_year_month>Optional

The year and month, in ISO-8601 `YYYY-MM` date format. See [Internet date and time format](https://tools.ietf.org/html/rfc3339#section-5.6).

Match^[0-9]{4}-(0[1-9]|1[0-2])$Length7 <= length <= 7

typeenum<card_type>Optional

Type of card. i.e Credit, Debit and so on.

Allowed values

"CREDIT"
"DEBIT"
"PREPAID"
"STORE"
"UNKNOWN"

brandenum<card_brand>Optional

The card network or brand. Applies to credit, debit, gift, and payment cards.

Allowed values

"VISA"
"MASTERCARD"
"DISCOVER"
"AMEX"
"SOLO"
"JCB"
"STAR"
"DELTA"
"SWITCH"
"MAESTRO"
"CB_NATIONALE"
"CONFIGOGA"

billing_addressobject<address_portable>Optional

address_portable properties

10 properties

address_line_1stringOptional

The first line of the address, such as number and street, for example, `173 Drury Lane`. Needed for data entry, and Compliance and Risk checks. This field needs to pass the full address.

Match^[\S\s]*$Length0 <= length <= 300

address_line_2stringOptional

The second line of the address, for example, a suite or apartment number.

Match^[\S\s]*$Length0 <= length <= 300

address_line_3stringOptional

The third line of the address, if needed. Examples include a street complement for Brazil, direction text, such as `next to Walmart`, or a landmark in an Indian address.

Match^[\S\s]*$Length0 <= length <= 100

admin_area_4stringOptional

The neighborhood, ward, or district. This is smaller than `admin_area_level_3` or `sub_locality`. Value is:

The postal sorting code that is used in Guernsey and many French territories, such as French Guiana.
The fine-grained administrative levels in China.

Match^[\S\s]*$Length0 <= length <= 100

admin_area_3stringOptional

The sub-locality, suburb, neighborhood, or district. This is smaller than `admin_area_level_2`. Value is:

Brazil. Suburb, *bairro*, or neighborhood.
India. Sub-locality or district. Street name information isn't always available, but a sub-locality or district can be a very small area.

Match^[\S\s]*$Length0 <= length <= 100

admin_area_2stringOptional

A city, town, or village. Smaller than `admin_area_level_1`.

Match^[\S\s]*$Length0 <= length <= 120

admin_area_1stringOptional

UK. A county.
US. A state.
Canada. A province.
Japan. A prefecture.
Switzerland. A *kanton*.

Match^[\S\s]*$Length0 <= length <= 300

postal_codestringOptional

The postal code, which is the ZIP code or equivalent. Typically required for countries with a postal code or an equivalent. See [postal code](https://en.wikipedia.org/wiki/Postal_code).

Match^[\S\s]*$Length0 <= length <= 60

country_codestring<country_code>Required

The [2-character ISO 3166-1 code](/api/rest/reference/country-codes/) that identifies the country or region.

Match^([A-Z]{2}|C2)$Length2 <= length <= 2

address_detailsobject<Address Details>Optional

decrypted_tokenobject<google_pay_decrypted_token_data>Optional

Details shared by Google for the merchant to be shared with PayPal. This is required to process the transaction using the Google Pay payment method.

google_pay_decrypted_token_data properties

7 properties

message_idstringOptional

A unique ID that identifies the message in case it needs to be revoked or located at a later time.

Match^.*$Length1 <= length <= 250

message_expirationstringOptional

Date and time at which the message expires as UTC milliseconds since epoch. Integrators should reject any message that's expired.

Match^\d{13}$Length13 <= length <= 13

payment_methodenumRequired

The type of the payment credential. Currently, only CARD is supported.

Allowed values

"CARD"

cardobject<google_pay_card>Required

Google Pay tokenized credit card used to pay.

google_pay_card properties

6 properties

namestringOptional

The card holder's name as it appears on the card.

Match^.{1,300}$Length1 <= length <= 300

numberstringRequired

The primary account number (PAN) for the payment card.

Match^[0-9]{13,19}$Length13 <= length <= 19

expirystring<date_year_month>Required

The year and month, in ISO-8601 `YYYY-MM` date format. See [Internet date and time format](https://tools.ietf.org/html/rfc3339#section-5.6).

Match^[0-9]{4}-(0[1-9]|1[0-2])$Length7 <= length <= 7

typeenum<card_type>Optional

Type of card. i.e Credit, Debit and so on.

Allowed values

"CREDIT"
"DEBIT"
"PREPAID"
"STORE"
"UNKNOWN"

brandenum<card_brand>Optional

The card network or brand. Applies to credit, debit, gift, and payment cards.

Allowed values

"VISA"
"MASTERCARD"
"DISCOVER"
"AMEX"
"SOLO"
"JCB"
"STAR"
"DELTA"
"SWITCH"
"MAESTRO"
"CB_NATIONALE"
"CONFIGOGA"

billing_addressobject<address_portable>Optional

address_portable properties

10 properties

address_line_1stringOptional

The first line of the address, such as number and street, for example, `173 Drury Lane`. Needed for data entry, and Compliance and Risk checks. This field needs to pass the full address.

Match^[\S\s]*$Length0 <= length <= 300

address_line_2stringOptional

The second line of the address, for example, a suite or apartment number.

Match^[\S\s]*$Length0 <= length <= 300

address_line_3stringOptional

The third line of the address, if needed. Examples include a street complement for Brazil, direction text, such as `next to Walmart`, or a landmark in an Indian address.

Match^[\S\s]*$Length0 <= length <= 100

admin_area_4stringOptional

The neighborhood, ward, or district. This is smaller than `admin_area_level_3` or `sub_locality`. Value is:

The postal sorting code that is used in Guernsey and many French territories, such as French Guiana.
The fine-grained administrative levels in China.

Match^[\S\s]*$Length0 <= length <= 100

admin_area_3stringOptional

The sub-locality, suburb, neighborhood, or district. This is smaller than `admin_area_level_2`. Value is:

Brazil. Suburb, *bairro*, or neighborhood.
India. Sub-locality or district. Street name information isn't always available, but a sub-locality or district can be a very small area.

Match^[\S\s]*$Length0 <= length <= 100

admin_area_2stringOptional

A city, town, or village. Smaller than `admin_area_level_1`.

Match^[\S\s]*$Length0 <= length <= 120

admin_area_1stringOptional

UK. A county.
US. A state.
Canada. A province.
Japan. A prefecture.
Switzerland. A *kanton*.

Match^[\S\s]*$Length0 <= length <= 300

postal_codestringOptional

The postal code, which is the ZIP code or equivalent. Typically required for countries with a postal code or an equivalent. See [postal code](https://en.wikipedia.org/wiki/Postal_code).

Match^[\S\s]*$Length0 <= length <= 60

country_codestring<country_code>Required

The [2-character ISO 3166-1 code](/api/rest/reference/country-codes/) that identifies the country or region.

Match^([A-Z]{2}|C2)$Length2 <= length <= 2

address_detailsobject<Address Details>Optional

authentication_methodenumRequired

Authentication Method which is used for the card transaction.

Allowed values

"PAN_ONLY"
"CRYPTOGRAM_3DS"

cryptogramstringOptional

Base-64 cryptographic identifier used by card schemes to validate the token verification result. This is a conditionally required field if authentication_method is CRYPTOGRAM_3DS.

Match^[\S\s]*$Length1 <= length <= 2000

eci_indicatorstringOptional

Electronic Commerce Indicator may not always be present. It is only returned for tokens on the Visa card network. This value is passed through in the payment authorization request.

Match^.*$Length1 <= length <= 256

assurance_detailsobject<assurance_details>Optional

Information about cardholder possession validation and cardholder identification and verifications (ID&V).

experience_contextobject<google_pay_experience_context>Optional

Customizes the payer experience during the approval process for the payment.

venmoobject<venmo_wallet_request>Optional

Information needed to pay using Venmo.

venmo_wallet_request properties

4 properties

vault_idstring<vault_id>Optional

The PayPal-generated ID for the vaulted payment source. This ID should be stored on the merchant's server so the saved payment source can be used for future transactions.

Match^[0-9a-zA-Z_-]+$Length1 <= length <= 255

email_addressstring<email>Optional

The internationalized email address.

experience_contextobject<venmo_wallet_experience_context>Optional

Customizes the buyer experience during the approval process for payment with Venmo.

attributesobject<venmo_wallet_attributes>Optional

Additional attributes associated with the use of this Venmo Wallet.

cryptoobject<crypto_request>Optional

Crypto payment used to fund the transaction.

crypto_request properties

3 properties

country_codestring<country_code>Required

The [2-character ISO 3166-1 code](/api/rest/reference/country-codes/) that identifies the country or region.

Match^([A-Z]{2}|C2)$Length2 <= length <= 2

nameobject<crypto_account_holder_name>Required

Crypto account holder name.

experience_contextobject<experience_context_base_without_brand_shipping>Required

Customizes the payer experience during the approval process for the payment.

Response Body

`application/json`

curl -X POST "https://example.com/v2/checkout/orders/5O190127TN364715T/authorize" \  -H "PayPal-Request-Id: 17e81d06-77ab-11e8-adc0-fa71639ebebc" \  -H "PayPal-Client-Metadata-Id: 1295065d-6f34-42dc-ac65-fac0c86af250" \  -H "Authorization: Bearer A21AAGHr9qtiRRXH4oYcQokQgV99rGqEIfgrr8xHCclP0OzmD9KVgg5ppIIg1jzJgQkV4wd02svIvBJyg6cLFJjFow_SjBhxQ" \  -H "PayPal-Auth-Assertion: eyJhbGciOiJub25lIn0.eyJlbWFpbCI6Im15QGVtYWlsLmNvbSJ9" \  -H "Content-Type: application/json" \  -d '{}'

{  "id": "5O190127TN364715T",  "status": "COMPLETED",  "payment_source": {    "paypal": {      "name": {        "given_name": "John",        "surname": "Doe"      },      "account_status": "VERIFIED",      "email_address": "customer@example.com",      "account_id": "QYR5Z8XDVJNXQ"    }  },  "purchase_units": [    {      "reference_id": "d9f80740-38f0-11e8-b467-0ed5f89f718b",      "shipping": {        "address": {          "address_line_1": "2211 N First Street",          "address_line_2": "Building 17",          "admin_area_2": "San Jose",          "admin_area_1": "CA",          "postal_code": "95131",          "country_code": "US"        }      },      "payments": {        "authorizations": [          {            "id": "0AW2184448108334S",            "status": "CREATED",            "amount": {              "currency_code": "USD",              "value": "100.00"            },            "seller_protection": {              "status": "ELIGIBLE",              "dispute_categories": [                "ITEM_NOT_RECEIVED",                "UNAUTHORIZED_TRANSACTION"              ]            },            "expiration_time": "2018-05-01T21:20:49Z",            "create_time": "2018-04-01T21:20:49Z",            "update_time": "2018-04-01T21:20:49Z",            "links": [              {                "href": "https://api-m.paypal.com/v2/payments/authorizations/0AW2184448108334S",                "rel": "self",                "method": "GET"              },              {                "href": "https://api-m.paypal.com/v2/payments/authorizations/0AW2184448108334S/capture",                "rel": "capture",                "method": "POST"              },              {                "href": "https://api-m.paypal.com/v2/payments/authorizations/0AW2184448108334S/void",                "rel": "void",                "method": "POST"              },              {                "href": "https://api-m.paypal.com/v2/payments/authorizations/0AW2184448108334S/reauthorize",                "rel": "reauthorize",                "method": "POST"              }            ]          }        ]      }    }  ],  "payer": {    "name": {      "given_name": "John",      "surname": "Doe"    },    "email_address": "customer@example.com",    "payer_id": "QYR5Z8XDVJNXQ"  },  "links": [    {      "href": "https://api-m.paypal.com/v2/checkout/orders/5O190127TN364715T",      "rel": "self",      "method": "GET"    }  ]}

On this page

If you accept cookies, we’ll use them to improve and customize your experience and enable our partners to show you personalized PayPal ads when you visit other sites. Manage cookies and learn more

Authorization

Path Parameters

Header Parameters

Request Body

payment_source properties

card_request properties

address_portable properties

Address Details properties

card_attributes properties

card_customer properties

phone_with_type properties

phone properties

name properties

vault_instruction_base properties

card_verification properties

card_stored_credential properties

network_transaction_reference properties

network_token_request properties

card_experience_context properties

token properties

paypal_wallet properties

name properties

phone_with_type properties

phone properties

tax_info properties

address_portable properties

Address Details properties

paypal_wallet_attributes properties

paypal_wallet_customer properties

phone_with_type properties

phone properties

name properties

vault_paypal_wallet_base properties

shipping_detail properties

name properties

phone properties

shipping_option properties

money properties

address_portable properties

Address Details properties

paypal_wallet_experience_context properties

app_switch_context properties

native_app_context properties

mobile_web_context properties

callback_configuration properties

paypal_wallet_stored_credential properties

bancontact_request properties

experience_context_base properties

blik_request properties

blik_experience_context properties

blik_seamless properties

blik_one_click properties

eps_request properties

experience_context_base properties

giropay_request properties

experience_context_base properties

ideal_request properties

experience_context_base properties

mybank_request properties

experience_context_base properties

p24_request properties

experience_context_base properties

sofort_request properties

experience_context_base properties

trustly_request properties

experience_context_base properties

apple_pay_request properties

phone_number_without_country_code properties

apple_pay_decrypted_token_data properties

money properties

card properties

address_portable properties

Address Details properties

card_attributes properties

card_customer properties

phone_with_type properties

phone properties

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`