Confirm the Order

API v2

SDK

Payer confirms their intent to pay for the the Order with the given payment source.

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
Initiates payments and checkout workflows.https://uri.paypal.com/services/payments/initiatepayment
Enables secure client-side integration on confirm payment source endpointhttps://uri.paypal.com/services/payments/orders/client_sdk_orders_api

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

payment_sourceobject<payment_source>Required

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.

Note: Passing card number, cvv and expiry directly via the API requires PCI SAQ D compliance.
*PayPal offers a mechanism by which you do not have to take on the PCI SAQ D burden by using hosted fields - refer to this Integration Guide*.

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.

Value in"CREDIT" | "DEBIT" | "PREPAID" | "STORE" | "UNKNOWN"

brandenum<card_brand>Optional

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

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_1string<currency_code>Optional

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_2string<currency_code>Optional

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

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

address_line_3string<currency_code>Optional

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_4string<currency_code>Optional

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_3string<currency_code>Optional

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_2string<currency_code>Optional

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

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

admin_area_1string<currency_code>Optional

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_codestring<currency_code>Optional

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.

Note: The country code for Great Britain is GB and not UK as used in the top-level domain names for that country. Use the `C2` country code for China worldwide for comparable uncontrolled price (CUP) method, bank card, and cross-border transactions.

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.

Value in"CUSTOMER" | "MERCHANT"

payment_typeenum<stored_payment_source_payment_type>Required

Indicates the type of the stored payment_source payment.

Value in"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).

Default"DERIVED"Value in"FIRST" | "SUBSEQUENT" | "DERIVED"

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.

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.

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_1string<currency_code>Optional

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_2string<currency_code>Optional

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

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

address_line_3string<currency_code>Optional

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_4string<currency_code>Optional

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_3string<currency_code>Optional

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_2string<currency_code>Optional

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

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

admin_area_1string<currency_code>Optional

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

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

postal_codestring<currency_code>Optional

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.

Note: The country code for Great Britain is GB and not UK as used in the top-level domain names for that country. Use the `C2` country code for China worldwide for comparable uncontrolled price (CUP) method, bank card, and cross-border transactions.

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.

Note: Partners and Marketplaces might configure brand_name and shipping_preference during partner account setup, which overrides the request values.

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.

Default"GET_FROM_FILE"Value in"GET_FROM_FILE" | "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.

Default"NO_CONTACT_INFO"Value in"NO_CONTACT_INFO" | "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.

Default"NO_PREFERENCE"Value in"LOGIN" | "GUEST_CHECKOUT" | "NO_PREFERENCE" | "BILLING"

user_actionenumOptional

Configures a Continue or Pay Now checkout flow.

Default"CONTINUE"Value in"CONTINUE" | "PAY_NOW"

payment_method_preferenceenumOptional

The merchant-preferred payment methods.

Default"UNRESTRICTED"Value in"UNRESTRICTED" | "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.

Value in"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.

usage_patternenum<charge_pattern>Optional

Expected business/pricing model for the billing agreement.

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).

Default"DERIVED"Value in"FIRST" | "SUBSEQUENT" | "DERIVED"

bancontactobject<bancontact_request>Optional

Information needed to pay using Bancontact.

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.

Note: The country code for Great Britain is GB and not UK as used in the top-level domain names for that country. Use the `C2` country code for China worldwide for comparable uncontrolled price (CUP) method, bank card, and cross-border transactions.

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

emailstring<email_address>Optional

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.

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.

Default"GET_FROM_FILE"Value in"GET_FROM_FILE" | "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.

giropayobject<giropay_request>Optional

Information needed to pay using giropay.

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.

Note: The country code for Great Britain is GB and not UK as used in the top-level domain names for that country. Use the `C2` country code for China worldwide for comparable uncontrolled price (CUP) method, bank card, and cross-border transactions.

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.

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.

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.

country_codestring<country_code-2>Required

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

Note: The country code for Great Britain is GB and not UK as used in the top-level domain names for that country. Use the `C2` country code for China worldwide for comparable uncontrolled price (CUP) method, bank card, and cross-border transactions.

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.

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.

Note: The country code for Great Britain is GB and not UK as used in the top-level domain names for that country. Use the `C2` country code for China worldwide for comparable uncontrolled price (CUP) method, bank card, and cross-border transactions.

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

emailstring<email_address>Required

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.

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.

google_payobject<google_pay_request>Optional

Information needed to pay using Google Pay.

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.

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.

experience_contextobject<venmo_wallet_experience_context>Optional

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

Note: Partners and Marketplaces might configure shipping_preference during partner account setup, which overrides the request values.

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.

Note: The country code for Great Britain is GB and not UK as used in the top-level domain names for that country. Use the `C2` country code for China worldwide for comparable uncontrolled price (CUP) method, bank card, and cross-border transactions.

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.

application_contextobject<order_confirm_application_context>Optional

Customizes the payer confirmation experience.

order_confirm_application_context properties

5 properties

brand_namestring<currency_code>Optional

Label to present to your payer as part of the PayPal hosted web experience.

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

localestring<language>Optional

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

return_urlstringOptional

The URL where the customer is redirected after the customer approves the payment.

FormaturiLength10 <= length <= 4000

cancel_urlstringOptional

The URL where the customer is redirected after the customer cancels the payment.

FormaturiLength10 <= length <= 4000

stored_payment_sourceobject<stored_payment_source>Optional

Provides additional details to process a payment using a `payment_source` 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.

stored_payment_source properties

4 properties

payment_initiatorenum<payment_initiator>Required

The person or party who initiated or triggered the payment.

Value in"CUSTOMER" | "MERCHANT"

payment_typeenum<stored_payment_source_payment_type>Required

Indicates the type of the stored payment_source payment.

Value in"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).

Default"DERIVED"Value in"FIRST" | "SUBSEQUENT" | "DERIVED"

previous_network_transaction_referenceobject<network_transaction_reference>Optional

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

Response Body

`application/json`

Request samples

using Microsoft.Extensions.Logging;
using PaypalServerSdk.Standard;
using PaypalServerSdk.Standard.Authentication;
using PaypalServerSdk.Standard.Controllers;
using PaypalServerSdk.Standard.Exceptions;
using PaypalServerSdk.Standard.Http.Response;
using PaypalServerSdk.Standard.Models;
using System;
using System.Collections.Generic;
using System.Threading.Tasks;

namespace TestConsoleProject
{
    public class Program
    {
        public static async Task Main()
        {
            PaypalServerSdkClient client = new PaypalServerSdkClient.Builder()
                .ClientCredentialsAuth(
                    new ClientCredentialsAuthModel.Builder(
                        "OAuthClientId",
                        "OAuthClientSecret"
                    )
                    .Build())
                .Environment(PaypalServerSdk.Standard.Environment.Sandbox)
                .LoggingConfig(config => config
                    .LogLevel(LogLevel.Information)
                    .RequestConfig(reqConfig => reqConfig.Body(true))
                    .ResponseConfig(respConfig => respConfig.Headers(true))
                )
                .Build();

            OrdersController ordersController = client.OrdersController;

            // Request body for this sample:
            // {
            //   "payment_source": {
            //     "paypal": {
            //       "name": {
            //         "given_name": "John",
            //         "surname": "Doe"
            //       },
            //       "email_address": "[email protected]",
            //       "experience_context": {
            //         "payment_method_preference": "IMMEDIATE_PAYMENT_REQUIRED",
            //         "brand_name": "EXAMPLE INC",
            //         "locale": "en-US",
            //         "landing_page": "LOGIN",
            //         "shipping_preference": "SET_PROVIDED_ADDRESS",
            //         "user_action": "PAY_NOW",
            //         "return_url": "https://example.com/returnUrl",
            //         "cancel_url": "https://example.com/cancelUrl"
            //       }
            //     }
            //   }
            // }

            ConfirmOrderInput confirmOrderInput = new ConfirmOrderInput
            {
                Id = "5O190127TN364715T",
                Prefer = "return=minimal",
            };

            try
            {
                ApiResponse<Order> result = await ordersController.ConfirmOrderAsync(confirmOrderInput);
            }
            catch (ApiException e)
            {
                Console.WriteLine(e.Message);
            }
        }
    }
}

Request Body

{
  "payment_source": {
    "paypal": {
      "name": {
        "given_name": "John",
        "surname": "Doe"
      },
      "email_address": "[email protected]",
      "experience_context": {
        "payment_method_preference": "IMMEDIATE_PAYMENT_REQUIRED",
        "brand_name": "EXAMPLE INC",
        "locale": "en-US",
        "landing_page": "LOGIN",
        "shipping_preference": "SET_PROVIDED_ADDRESS",
        "user_action": "PAY_NOW",
        "return_url": "https://example.com/returnUrl",
        "cancel_url": "https://example.com/cancelUrl"
      }
    }
  }
}

Response samples

{  "id": "5O190127TN364715T",  "payment_source": {    "paypal": {      "name": {        "given_name": "John",        "surname": "Doe"      },      "email_address": "[email protected]"    }  },  "payer": {    "name": {      "given_name": "John",      "surname": "Doe"    },    "email_address": "[email protected]"  },  "links": [    {      "href": "https://api.paypal.com/v2/checkout/orders/5O190127TN364715T",      "rel": "self",      "method": "GET"    },    {      "href": "https://www.paypal.com/checkoutnow?token=5O190127TN364715T",      "rel": "payer-action",      "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_number_without_country_code 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_number_without_country_code properties

tax_info properties

address_portable properties

Address Details properties

paypal_wallet_attributes properties

paypal_wallet_customer properties

phone_with_type properties

phone_number_without_country_code 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

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_number_without_country_code properties

name properties

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`