An order represents a payment between two or more parties. Use the Orders API to create, update, retrieve, authorize, and capture orders.
Creates an order. Merchants and partners can add Level 2 and 3 data to payments to reduce risk and payment processing costs. For more information about processing payments, see checkout or multiparty checkout.
Note: For error handling and troubleshooting, see Orders v2 errors.
PayPal-Request-Id | string [ 1 .. 108 ] characters The server stores keys for 6 hours. The API callers can request the times to up to 72 hours by speaking to their Account Manager. It is mandatory for all single-step create order calls (E.g. Create Order Request with payment source information like Card, PayPal.vault_id, PayPal.billing_agreement_id, etc). |
PayPal-Partner-Attribution-Id | string [ 1 .. 36 ] characters |
PayPal-Client-Metadata-Id | string [ 1 .. 36 ] characters |
Prefer | string [ 1 .. 25 ] characters ^[a-zA-Z=,-]*$ Default: return=minimal The preferred server response upon successful completion of the request. Value is:
|
Authorization required | string To make REST API calls, include the bearer token in this header with the |
PayPal-Auth-Assertion | string An API-caller-provided JSON Web Token (JWT) assertion that identifies the merchant. For details, see PayPal-Auth-Assertion. |
Content-Type required | string [ 1 .. 255 ] characters ^[A-Za-z0-9/+-]+$ The media type. Required for operations with a request body. The value is |
A successful response to an idempotent request returns the HTTP 200 OK
status code with a JSON response body that shows order details.
curl -v -X POST https://api-m.sandbox.paypal.com/v2/checkout/orders \ -H 'Content-Type: application/json' \ -H 'PayPal-Request-Id: 7b92603e-77ed-4896-8e78-5dea2050476a' \ -H 'Authorization: Bearer 6V7rbVwmlM1gFZKW_8QtzWXqpcwQ6T5vhEGYNJDAAdn3paCgRpdeMdVYmWzgbKSsECednupJ3Zx5Xd-g' \ -d '{ "intent": "CAPTURE", "payment_source": { "paypal": { "experience_context": { "payment_method_preference": "IMMEDIATE_PAYMENT_REQUIRED", "landing_page": "LOGIN", "shipping_preference": "GET_FROM_FILE", "user_action": "PAY_NOW", "return_url": "https://example.com/returnUrl", "cancel_url": "https://example.com/cancelUrl" } } }, "purchase_units": [ { "invoice_id": "90210", "amount": { "currency_code": "USD", "value": "230.00", "breakdown": { "item_total": { "currency_code": "USD", "value": "220.00" }, "shipping": { "currency_code": "USD", "value": "10.00" } } }, "items": [ { "name": "T-Shirt", "description": "Super Fresh Shirt", "unit_amount": { "currency_code": "USD", "value": "20.00" }, "quantity": "1", "category": "PHYSICAL_GOODS", "sku": "sku01", "image_url": "https://example.com/static/images/items/1/tshirt_green.jpg", "url": "https://example.com/url-to-the-item-being-purchased-1", "upc": { "type": "UPC-A", "code": "123456789012" } }, { "name": "Shoes", "description": "Running, Size 10.5", "sku": "sku02", "unit_amount": { "currency_code": "USD", "value": "100.00" }, "quantity": "2", "category": "PHYSICAL_GOODS", "image_url": "https://example.com/static/images/items/1/shoes_running.jpg", "url": "https://example.com/url-to-the-item-being-purchased-2", "upc": { "type": "UPC-A", "code": "987654321012" } } ] } ] }'
{- "id": "5O190127TN364715T",
- "status": "PAYER_ACTION_REQUIRED",
- "payment_source": {
- "paypal": { }
}, - "links": [
- {
- "rel": "self",
- "method": "GET"
}, - {
- "rel": "payer-action",
- "method": "GET"
}
]
}
Shows details for an order, by ID.
Note: For error handling and troubleshooting, see Orders v2 errors.
Authorization required | string To make REST API calls, include the bearer token in this header with the |
PayPal-Auth-Assertion | string An API-caller-provided JSON Web Token (JWT) assertion that identifies the merchant. For details, see PayPal-Auth-Assertion. |
Content-Type required | string [ 1 .. 255 ] characters ^[A-Za-z0-9/+-]+$ The media type. Required for operations with a request body. The value is |
A successful request returns the HTTP 200 OK
status code and a JSON response body that shows order details.
curl -v -X GET https://api-m.sandbox.paypal.com/v2/checkout/orders/5O190127TN364715T \ -H 'Authorization: Bearer 6V7rbVwmlM1gFZKW_8QtzWXqpcwQ6T5vhEGYNJDAAdn3paCgRpdeMdVYmWzgbKSsECednupJ3Zx5Xd-g'
{- "id": "5O190127TN364715T",
- "status": "APPROVED",
- "intent": "CAPTURE",
- "payment_source": {
- "paypal": {
- "name": {
- "given_name": "John",
- "surname": "Doe"
}, - "email_address": "customer@example.com",
- "account_id": "QYR5Z8XDVJNXQ"
}
}, - "purchase_units": [
- {
- "reference_id": "d9f80740-38f0-11e8-b467-0ed5f89f718b",
- "amount": {
- "currency_code": "USD",
- "value": "100.00"
}
}
], - "payer": {
- "name": {
- "given_name": "John",
- "surname": "Doe"
}, - "email_address": "customer@example.com",
- "payer_id": "QYR5Z8XDVJNXQ"
}, - "create_time": "2018-04-01T21:18:49Z",
- "links": [
- {
- "rel": "self",
- "method": "GET"
}, - {
- "rel": "approve",
- "method": "GET"
}, - {
- "rel": "update",
- "method": "PATCH"
}, - {
- "rel": "capture",
- "method": "POST"
}
]
}
Updates an order with a CREATED
or APPROVED
status. You cannot update an order with the COMPLETED
status.
To make an update, you must provide a reference_id
. If you omit this value with an order that contains only one purchase unit, PayPal sets the value to default
which enables you to use the path: "/purchase_units/@reference_id=='default'/{attribute-or-object}"
. Merchants and partners can add Level 2 and 3 data to payments to reduce risk and payment processing costs. For more information about processing payments, see checkout or multiparty checkout.
Note: For error handling and troubleshooting, see Orders v2 errors.Patchable attributes or objects:
Attribute | Op | Notes |
---|---|---|
intent | replace | |
payer | replace, add | Using replace op for payer will replace the whole payer object with the value sent in request. |
purchase_units | replace, add | |
purchase_units[].custom_id | replace, add, remove | |
purchase_units[].description | replace, add, remove | |
purchase_units[].payee.email | replace | |
purchase_units[].shipping.name | replace, add | |
purchase_units[].shipping.email_address | replace, add | |
purchase_units[].shipping.phone_number | replace, add | |
purchase_units[].shipping.options | replace, add | |
purchase_units[].shipping.address | replace, add | |
purchase_units[].shipping.type | replace, add | |
purchase_units[].soft_descriptor | replace, remove | |
purchase_units[].amount | replace | |
purchase_units[].items | replace, add, remove | |
purchase_units[].invoice_id | replace, add, remove | |
purchase_units[].payment_instruction | replace | |
purchase_units[].payment_instruction.disbursement_mode | replace | By default, disbursement_mode is INSTANT . |
purchase_units[].payment_instruction.payee_receivable_fx_rate_id | replace, add, remove | |
purchase_units[].payment_instruction.platform_fees | replace, add, remove | |
purchase_units[].supplementary_data.airline | replace, add, remove | |
purchase_units[].supplementary_data.card | replace, add, remove | |
application_context.client_configuration | replace, add |
Authorization required | string To make REST API calls, include the bearer token in this header with the |
PayPal-Auth-Assertion | string An API-caller-provided JSON Web Token (JWT) assertion that identifies the merchant. For details, see PayPal-Auth-Assertion. |
Content-Type required | string [ 1 .. 255 ] characters ^[A-Za-z0-9/+-]+$ The media type. Required for operations with a request body. The value is |
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 |
A successful request returns the HTTP 204 No Content
status code with an empty object in the JSON response body.
curl -v -X PATCH https://api-m.sandbox.paypal.com/v2/checkout/orders/5O190127TN364715T \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer V7rbVwmlM1gFZKW_8QtzWXqpcwQ6T5vhEGYNJDAAdn3paCgRpdeMdVYmWzgbKSsECednupJ3Zx5Xd-g' \ -d '[ { "op": "replace", "path": "/purchase_units/@reference_id=='PUHF'/shipping/address", "value": { "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" } } ]'
Payer confirms their intent to pay for the the Order with the given payment source.
PayPal-Client-Metadata-Id | string [ 1 .. 36 ] characters |
Authorization required | string To make REST API calls, include the bearer token in this header with the |
PayPal-Auth-Assertion | string An API-caller-provided JSON Web Token (JWT) assertion that identifies the merchant. For details, see PayPal-Auth-Assertion. |
Content-Type required | string [ 1 .. 255 ] characters ^[A-Za-z0-9/+-]+$ The media type. Required for operations with a request body. The value is |
Prefer | string [ 1 .. 25 ] characters ^[a-zA-Z=]*$ Default: return=minimal The preferred server response upon successful completion of the request. Value is:
|
object (Order Confirm Application Context) Customizes the payer confirmation experience. | |
required | object (payment_source) The payment source definition. |
A successful request indicates that the payment source was added to the Order. A successful request returns the HTTP 200 OK
status code with a JSON response body that shows order details.
curl -v -X POST https://api-m.sandbox.paypal.com/v2/checkout/orders/5O190127TN364715T/confirm-payment-source \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer 6V7rbVwmlM1gFZKW_8QtzWXqpcwQ6T5vhEGYNJDAAdn3paCgRpdeMdVYmWzgbKSsECednupJ3Zx5Xd-g' \ -d '{ "payment_source": { "paypal": { "name": { "given_name": "John", "surname": "Doe" }, "email_address": "customer@example.com", "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" } } } }'
{- "id": "5O190127TN364715T",
- "status": "PAYER_ACTION_REQUIRED",
- "payment_source": {
- "paypal": {
- "name": {
- "given_name": "John",
- "surname": "Doe"
}, - "email_address": "customer@example.com"
}
}, - "payer": {
- "name": {
- "given_name": "John",
- "surname": "Doe"
}, - "email_address": "customer@example.com"
}, - "links": [
- {
- "rel": "self",
- "method": "GET"
}, - {
- "rel": "payer-action",
- "method": "GET"
}
]
}
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.
Note: For error handling and troubleshooting, see Orders v2 errors.
PayPal-Request-Id | string [ 1 .. 108 ] characters The server stores keys for 6 hours. The API callers can request the times to up to 72 hours by speaking to their Account Manager. It is mandatory for all single-step create order calls (E.g. Create Order Request with payment source information like Card, PayPal.vault_id, PayPal.billing_agreement_id, etc). |
Prefer | string [ 1 .. 25 ] characters ^[a-zA-Z=,-]*$ Default: return=minimal The preferred server response upon successful completion of the request. Value is:
|
PayPal-Client-Metadata-Id | string [ 1 .. 36 ] characters |
Authorization required | string To make REST API calls, include the bearer token in this header with the |
PayPal-Auth-Assertion | string An API-caller-provided JSON Web Token (JWT) assertion that identifies the merchant. For details, see PayPal-Auth-Assertion. |
Content-Type required | string [ 1 .. 255 ] characters ^[A-Za-z0-9/+-]+$ The media type. Required for operations with a request body. The value is |
object (payment_source) The source of payment for the order, which can be a token or a card. Use this object only if you have not redirected the user after order creation to approve the payment. In such cases, the user-selected payment method in the PayPal flow is implicitly used. |
A successful response to a non-idempotent request returns the HTTP 201 Created
status code with a JSON response body that shows authorized payment details. If a duplicate response is retried, returns the HTTP 200 OK
status code. By default, the response is minimal. If you need the complete resource representation, you must pass the Prefer: return=representation
request header.
curl -v -X POST https://api-m.sandbox.paypal.com/v2/checkout/orders/5O190127TN364715T/authorize \ -H 'Content-Type: application/json' \ -H 'PayPal-Request-Id: 7b92603e-77ed-4896-8e78-5dea2050476a' \ -H 'Authorization: Bearer 6V7rbVwmlM1gFZKW_8QtzWXqpcwQ6T5vhEGYNJDAAdn3paCgRpdeMdVYmWzgbKSsECednupJ3Zx5Xd-g'
{- "id": "5O190127TN364715T",
- "status": "COMPLETED",
- "payment_source": {
- "paypal": {
- "name": {
- "given_name": "John",
- "surname": "Doe"
}, - "email_address": "customer@example.com",
- "account_id": "QYR5Z8XDVJNXQ"
}
}, - "purchase_units": [
- {
- "reference_id": "d9f80740-38f0-11e8-b467-0ed5f89f718b",
- "payments": {
- "authorizations": [
- {
- "id": "3C679366HH908993F",
- "status": "CREATED",
- "amount": {
- "currency_code": "USD",
- "value": "100.00"
}, - "seller_protection": {
- "status": "ELIGIBLE",
- "dispute_categories": [
- "ITEM_NOT_RECEIVED",
- "UNAUTHORIZED_TRANSACTION"
]
}, - "expiration_time": "2021-10-08T23:37:39Z",
- "links": [
- {
- "rel": "self",
- "method": "GET"
}, - {
- "rel": "capture",
- "method": "POST"
}, - {
- "rel": "void",
- "method": "POST"
}, - {
- "rel": "up",
- "method": "GET"
}
]
}
]
}
}
], - "payer": {
- "name": {
- "given_name": "John",
- "surname": "Doe"
}, - "email_address": "customer@example.com",
- "payer_id": "QYR5Z8XDVJNXQ"
}, - "links": [
- {
- "rel": "self",
- "method": "GET"
}
]
}
Captures payment for an order. To successfully capture 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.
Note: For error handling and troubleshooting, see Orders v2 errors.
PayPal-Request-Id | string [ 1 .. 108 ] characters The server stores keys for 6 hours. The API callers can request the times to up to 72 hours by speaking to their Account Manager. It is mandatory for all single-step create order calls (E.g. Create Order Request with payment source information like Card, PayPal.vault_id, PayPal.billing_agreement_id, etc). |
Prefer | string [ 1 .. 25 ] characters ^[a-zA-Z=,-]*$ Default: return=minimal The preferred server response upon successful completion of the request. Value is:
|
PayPal-Client-Metadata-Id | string [ 1 .. 36 ] characters |
Authorization required | string To make REST API calls, include the bearer token in this header with the |
PayPal-Auth-Assertion | string An API-caller-provided JSON Web Token (JWT) assertion that identifies the merchant. For details, see PayPal-Auth-Assertion. |
Content-Type required | string [ 1 .. 255 ] characters ^[A-Za-z0-9/+-]+$ The media type. Required for operations with a request body. The value is |
object (payment_source) The payment source definition. |
A successful response to a non-idempotent request returns the HTTP 201 Created
status code with a JSON response body that shows captured payment details. If a duplicate response is retried, returns the HTTP 200 OK
status code. By default, the response is minimal. If you need the complete resource representation, pass the Prefer: return=representation
request header.
curl -v -X POST https://api-m.sandbox.paypal.com/v2/checkout/orders/5O190127TN364715T/capture \ -H 'Content-Type: application/json' \ -H 'PayPal-Request-Id: 7b92603e-77ed-4896-8e78-5dea2050476a' \ -H 'Authorization: Bearer 6V7rbVwmlM1gFZKW_8QtzWXqpcwQ6T5vhEGYNJDAAdn3paCgRpdeMdVYmWzgbKSsECednupJ3Zx5Xd-g'
{- "id": "5O190127TN364715T",
- "status": "COMPLETED",
- "payment_source": {
- "paypal": {
- "name": {
- "given_name": "John",
- "surname": "Doe"
}, - "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": {
- "captures": [
- {
- "id": "3C679366HH908993F",
- "status": "COMPLETED",
- "amount": {
- "currency_code": "USD",
- "value": "100.00"
}, - "seller_protection": {
- "status": "ELIGIBLE",
- "dispute_categories": [
- "ITEM_NOT_RECEIVED",
- "UNAUTHORIZED_TRANSACTION"
]
}, - "final_capture": true,
- "disbursement_mode": "INSTANT",
- "seller_receivable_breakdown": {
- "gross_amount": {
- "currency_code": "USD",
- "value": "100.00"
}, - "paypal_fee": {
- "currency_code": "USD",
- "value": "3.00"
}, - "net_amount": {
- "currency_code": "USD",
- "value": "97.00"
}
}, - "create_time": "2018-04-01T21:20:49Z",
- "update_time": "2018-04-01T21:20:49Z",
- "links": [
- {
- "rel": "self",
- "method": "GET"
}, - {
- "rel": "refund",
- "method": "POST"
}
]
}
]
}
}
], - "payer": {
- "name": {
- "given_name": "John",
- "surname": "Doe"
}, - "email_address": "customer@example.com",
- "payer_id": "QYR5Z8XDVJNXQ"
}, - "links": [
- {
- "rel": "self",
- "method": "GET"
}
]
}
Adds tracking information for an Order.
Authorization required | string To make REST API calls, include the bearer token in this header with the |
PayPal-Auth-Assertion | string An API-caller-provided JSON Web Token (JWT) assertion that identifies the merchant. For details, see PayPal-Auth-Assertion. |
Content-Type required | string [ 1 .. 255 ] characters ^[A-Za-z0-9/+-]+$ The media type. Required for operations with a request body. The value is |
tracking_number required | string [ 1 .. 64 ] characters The tracking number for the shipment. This property supports Unicode. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
carrier_name_other | string [ 1 .. 64 ] characters The name of the carrier for the shipment. Provide this value only if the carrier parameter is OTHER. This property supports Unicode. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
carrier required | string (carrier) [ 1 .. 64 ] characters ^[0-9A-Z_]+$ The carrier for the shipment. Some carriers have a global version as well as local subsidiaries. The subsidiaries are repeated over many countries and might also have an entry in the global list. Choose the carrier for your country. If the carrier is not available for your country, choose the global version of the carrier. If your carrier name is not in the list, set
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
capture_id required | string [ 1 .. 50 ] characters ^[a-zA-Z0-9]*$ The PayPal capture ID. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
notify_payer | boolean Default: false If true, sends an email notification to the payer of the PayPal transaction. The email contains the tracking information that was uploaded through the API. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Array of objects (tracker_item) An array of details of items in the shipment. |
A successful response to a non-idempotent request returns the HTTP 201 Created
status code with a JSON response body that shows tracker details. If a duplicate response is retried, returns the HTTP 200 OK
status code.
curl -v -X POST https://api-m.sandbox.paypal.com/v2/checkout/orders/5O190127TN364715T/track \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer 6V7rbVwmlM1gFZKW_8QtzWXqpcwQ6T5vhEGYNJDAAdn3paCgRpdeMdVYmWzgbKSsECednupJ3Zx5Xd-g' \ -d '{ "capture_id": "8MC585209K746392H", "tracking_number": "443844607820", "carrier": "FEDEX", "notify_payer": false, "items": [ { "name": "T-Shirt", "sku": "sku02", "quantity": "1", "upc": { "type": "UPC-A", "code": "upc001" }, "image_url": "https://www.example.com/example.jpg", "url": "https://www.example.com/example" } ] }'
{- "id": "5O190127TN364715T",
- "status": "COMPLETED",
- "purchase_units": [
- {
- "reference_id": "d9f80740-38f0-11e8-b467-0ed5f89f718b",
- "items": [
- {
- "name": "Air Jordan Shoe",
- "sku": "sku01",
- "quantity": "1"
}, - {
- "name": "T-Shirt",
- "sku": "sku02",
- "quantity": "1"
}
], - "shipping": {
- "trackers": [
- {
- "id": "8MC585209K746392H-443844607820",
- "links": [
- {
- "rel": "up",
- "method": "GET"
}, - {
- "rel": "update",
- "method": "PATCH"
}
], - "create_time": "2022-08-12T21:20:49Z",
- "update_time": "2022-08-12T21:20:49Z"
}
]
}, - "payments": {
- "captures": [
- {
- "id": "8MC585209K746392H",
- "status": "COMPLETED",
- "amount": {
- "currency_code": "USD",
- "value": "100.00"
}, - "seller_protection": {
- "status": "NOT_ELIGIBLE"
}, - "final_capture": true,
- "seller_receivable_breakdown": {
- "gross_amount": {
- "currency_code": "USD",
- "value": "100.00"
}, - "paypal_fee": {
- "currency_code": "USD",
- "value": "3.00"
}, - "net_amount": {
- "currency_code": "USD",
- "value": "97.00"
}
}, - "create_time": "2018-04-01T21:20:49Z",
- "update_time": "2018-04-01T21:20:49Z",
- "links": [
- {
- "rel": "self",
- "method": "GET"
}, - {
- "rel": "refund",
- "method": "POST"
}
]
}
]
}
}
], - "links": [
- {
- "rel": "self",
- "method": "GET"
}
]
}
Updates or cancels the tracking information for a PayPal order, by ID. Updatable attributes or objects:
Attribute | Op | Notes |
---|---|---|
items | replace | Using replace op for items will replace the entire items object with the value sent in request. |
notify_payer | replace, add | |
status | replace | Only patching status to CANCELLED is currently supported. |
Authorization required | string To make REST API calls, include the bearer token in this header with the |
PayPal-Auth-Assertion | string An API-caller-provided JSON Web Token (JWT) assertion that identifies the merchant. For details, see PayPal-Auth-Assertion. |
Content-Type required | string [ 1 .. 255 ] characters ^[A-Za-z0-9/+-]+$ The media type. Required for operations with a request body. The value is |
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 |
A successful request returns the HTTP 204 No Content
status code with an empty object in the JSON response body.
curl -v -X PATCH https://api-m.sandbox.paypal.com/v2/checkout/orders/5O190127TN364715T/trackers/8MC585209K746392H-443844607820 \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer 6V7rbVwmlM1gFZKW_8QtzWXqpcwQ6T5vhEGYNJDAAdn3paCgRpdeMdVYmWzgbKSsECednupJ3Zx5Xd-g' \ -d '[ { "op": "add", "path": "/notify_payer", "value": true } ]'
The PayPal payer ID, which is a masked version of the PayPal account number intended for use with third parties. The account number is reversibly encrypted and a proprietary variant of Base32 is used to encode the result.
The PayPal payer ID, which is a masked version of the PayPal account number intended for use with third parties. The account number is reversibly encrypted and a proprietary variant of Base32 is used to encode the result.
"stringstrings"
The date and time stamps that are common to authorized payment, captured payment, and refund transactions.
create_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 date and time when the transaction occurred, in Internet date and time format. |
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 date and time when the transaction was last updated, in Internet date and time format. |
{- "create_time": "stringstringstringst",
- "update_time": "stringstringstringst"
}
The breakdown of the amount. Breakdown provides details such as total item amount, total tax amount, shipping, handling, insurance, and discounts, if any.
object (Money) The subtotal for all items. Required if the request includes | |
object (Money) The shipping fee for all items within a given | |
object (Money) The handling fee for all items within a given | |
object (Money) The total tax for all items. Required if the request includes | |
object (Money) The insurance fee for all items within a given | |
object (Money) The shipping discount for all items within a given | |
object (Money) The discount for all items within a given |
{- "item_total": {
- "currency_code": "str",
- "value": "string"
}, - "shipping": {
- "currency_code": "str",
- "value": "string"
}, - "handling": {
- "currency_code": "str",
- "value": "string"
}, - "tax_total": {
- "currency_code": "str",
- "value": "string"
}, - "insurance": {
- "currency_code": "str",
- "value": "string"
}, - "shipping_discount": {
- "currency_code": "str",
- "value": "string"
}, - "discount": {
- "currency_code": "str",
- "value": "string"
}
}
The total order amount with an optional breakdown that provides details, such as the total item amount, total tax amount, shipping, handling, insurance, and discounts, if any.
If you specify amount.breakdown
, the amount equals item_total
plus tax_total
plus shipping
plus handling
plus insurance
minus shipping_discount
minus discount.
The amount must be a positive number. For listed of supported currencies and decimal precision, see the PayPal REST APIs Currency Codes.
currency_code required | string <ppaas_common_currency_code_v2> (currency_code) = 3 characters The three-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:
|
object (amount_breakdown) The breakdown of the amount. Breakdown provides details such as total item amount, total tax amount, shipping, handling, insurance, and discounts, if any. |
{- "currency_code": "str",
- "value": "string",
- "breakdown": {
- "item_total": {
- "currency_code": "str",
- "value": "string"
}, - "shipping": {
- "currency_code": "str",
- "value": "string"
}, - "handling": {
- "currency_code": "str",
- "value": "string"
}, - "tax_total": {
- "currency_code": "str",
- "value": "string"
}, - "insurance": {
- "currency_code": "str",
- "value": "string"
}, - "shipping_discount": {
- "currency_code": "str",
- "value": "string"
}, - "discount": {
- "currency_code": "str",
- "value": "string"
}
}
}
Information needed to pay using ApplePay.
id | string [ 1 .. 250 ] characters ^.*$ 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. |
token | string [ 1 .. 10000 ] characters ^.*$ Encrypted ApplePay token, containing card information. This token would be base64encoded. The pattern is defined by an external party and supports Unicode. |
name | string (name) [ 3 .. 300 ] characters Name on the wallet. |
email_address | string <ppaas_common_email_address_v2> (email_address) [ 3 .. 254 ] characters ^(?:[A-Za-z0-9!#$%&'*+/=?^_`{|}~-]+(?:\.[A-Za... The email address of the account holder associated with this payment method. |
object (Phone) The phone number, in its canonical international E.164 numbering plan format. Supports only the | |
object (apple_pay_card_response) The payment card information. | |
object (apple_pay_attributes_response) Additional attributes associated with apple pay. |
{- "id": "string",
- "token": "string",
- "name": "string",
- "email_address": "string",
- "phone_number": {
- "national_number": "string"
}, - "card": {
- "name": "string",
- "last_digits": "string",
- "available_networks": [
- "VISA"
], - "from_request": {
- "last_digits": "stri",
- "expiry": "string"
}, - "brand": "VISA",
- "type": "CREDIT",
- "authentication_result": {
- "liability_shift": "NO",
- "three_d_secure": {
- "authentication_status": "Y",
- "enrollment_status": "Y"
}
}, - "attributes": {
- "vault": {
- "id": "string",
- "status": "VAULTED",
- "links": [
- {
- "href": "string",
- "rel": "string",
- "method": "GET"
}
], - "customer": {
- "id": "string",
- "email_address": "string",
- "phone": {
- "phone_type": "FAX",
- "phone_number": {
- "national_number": "string"
}
}, - "merchant_customer_id": "string"
}
}
}, - "expiry": "string",
- "bin_details": {
- "bin": "string",
- "issuing_bank": "string",
- "products": [
- "string"
], - "bin_country_code": "string"
}, - "billing_address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}, - "country_code": "string"
}, - "attributes": {
- "vault": {
- "id": "string",
- "status": "VAULTED",
- "links": [
- {
- "href": "string",
- "rel": "string",
- "method": "GET"
}
], - "customer": {
- "id": "string"
}
}
}
}
Additional attributes associated with apple pay.
object (customer) The details about a customer in PayPal's system of record. | |
object (v3_vault_instruction_base) Base vaulting specification. The object can be extended for specific use cases within each payment_source that supports vaulting. |
{- "customer": {
- "id": "string",
- "email_address": "string",
- "phone": {
- "phone_type": "FAX",
- "phone_number": {
- "national_number": "string"
}
}
}, - "vault": {
- "store_in_vault": "ON_SUCCESS"
}
}
Additional attributes associated with the use of Apple Pay.
object (vault_response) The details about a saved payment source. |
{- "vault": {
- "id": "string",
- "status": "VAULTED",
- "links": [
- {
- "href": "string",
- "rel": "string",
- "method": "GET"
}
], - "customer": {
- "id": "string"
}
}
}
The Card from Apple Pay Wallet used to fund the payment.
name | string [ 2 .. 300 ] characters The card holder's name as it appears on the card. | ||||||||||||||||||||||||||||||||||||||||||||||||||||
last_digits | string[0-9]{2,} The last digits of the payment card. | ||||||||||||||||||||||||||||||||||||||||||||||||||||
available_networks | Array of strings (card_brand) [ 1 .. 256 ] items Array of brands or networks associated with the card.
| ||||||||||||||||||||||||||||||||||||||||||||||||||||
object (card_from_request) Representation of card details as received in the request. | |||||||||||||||||||||||||||||||||||||||||||||||||||||
brand | string (card_brand) [ 1 .. 255 ] characters ^[A-Z_]+$ The card brand or network. Typically used in the response.
| ||||||||||||||||||||||||||||||||||||||||||||||||||||
type | string (card_type) [ 1 .. 255 ] characters ^[A-Z_]+$ The payment card type.
| ||||||||||||||||||||||||||||||||||||||||||||||||||||
object (authentication_response) Results of Authentication such as 3D Secure. | |||||||||||||||||||||||||||||||||||||||||||||||||||||
object (card_attributes_response) Additional attributes associated with the use of this card. | |||||||||||||||||||||||||||||||||||||||||||||||||||||
expiry | string (date_year_month) = 7 characters ^[0-9]{4}-(0[1-9]|1[0-2])$ The card expiration year and month, in Internet date format. | ||||||||||||||||||||||||||||||||||||||||||||||||||||
object (bin_details) Bank Identification Number (BIN) details used to fund a payment. | |||||||||||||||||||||||||||||||||||||||||||||||||||||
object (Portable Postal Address (Medium-Grained)) The portable international postal address. Maps to AddressValidationMetadata and HTML 5.1 Autofilling form controls: the autocomplete attribute. | |||||||||||||||||||||||||||||||||||||||||||||||||||||
country_code | 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 |
{- "name": "string",
- "last_digits": "string",
- "available_networks": [
- "VISA"
], - "from_request": {
- "last_digits": "stri",
- "expiry": "string"
}, - "brand": "VISA",
- "type": "CREDIT",
- "authentication_result": {
- "liability_shift": "NO",
- "three_d_secure": {
- "authentication_status": "Y",
- "enrollment_status": "Y"
}
}, - "attributes": {
- "vault": {
- "id": "string",
- "status": "VAULTED",
- "links": [
- {
- "href": "string",
- "rel": "string",
- "method": "GET"
}
], - "customer": {
- "id": "string",
- "email_address": "string",
- "phone": {
- "phone_type": "FAX",
- "phone_number": {
- "national_number": "string"
}
}, - "merchant_customer_id": "string"
}
}
}, - "expiry": "string",
- "bin_details": {
- "bin": "string",
- "issuing_bank": "string",
- "products": [
- "string"
], - "bin_country_code": "string"
}, - "billing_address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}, - "country_code": "string"
}
Information about the Payment data obtained by decrypting Apple Pay token.
device_manufacturer_id | string [ 1 .. 2000 ] characters ^.*$ Apple Pay Hex-encoded device manufacturer identifier. The pattern is defined by an external party and supports Unicode. | ||||||
payment_data_type | string [ 1 .. 16 ] characters ^[0-9A-Z_]+$ Indicates the type of payment data passed, in case of Non China the payment data is 3DSECURE and for China it is EMV.
| ||||||
object (Money) The transaction amount for the payment that the payer has approved on apple platform. | |||||||
required | object (card) Apple Pay tokenized credit card used to pay. | ||||||
object (apple_pay_payment_data) Apple Pay payment data object which contains the cryptogram, eci_indicator and other data. |
{- "device_manufacturer_id": "string",
- "payment_data_type": "3DSECURE",
- "transaction_amount": {
- "currency_code": "str",
- "value": "string"
}, - "tokenized_card": {
- "name": "string",
- "number": "stringstrings",
- "expiry": "string",
- "card_type": "VISA",
- "type": "CREDIT",
- "brand": "VISA",
- "billing_address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
}, - "payment_data": {
- "cryptogram": "string",
- "eci_indicator": "string",
- "emv_data": "string",
- "pin": "string"
}
}
Information about the decrypted apple pay payment data for the token like cryptogram, eci indicator.
cryptogram | string [ 1 .. 2000 ] characters ^.*$ Online payment cryptogram, as defined by 3D Secure. The pattern is defined by an external party and supports Unicode. |
eci_indicator | string [ 1 .. 256 ] characters ^.*$ ECI indicator, as defined by 3- Secure. The pattern is defined by an external party and supports Unicode. |
emv_data | string [ 1 .. 2000 ] characters ^.*$ Encoded Apple Pay EMV Payment Structure used for payments in China. The pattern is defined by an external party and supports Unicode. |
pin | string [ 1 .. 2000 ] characters ^.*$ Bank Key encrypted Apple Pay PIN. The pattern is defined by an external party and supports Unicode. |
{- "cryptogram": "string",
- "eci_indicator": "string",
- "emv_data": "string",
- "pin": "string"
}
Information needed to pay using ApplePay.
id | string [ 1 .. 250 ] characters ^.*$ 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. |
object (card_stored_credential) Provides additional details to process a payment using a
| |
object (apple_pay_attributes) Additional attributes associated with apple pay. | |
name | string (name) [ 3 .. 300 ] characters Name on the account holder associated with apple pay. |
email_address | string <ppaas_common_email_address_v2> (email_address) [ 3 .. 254 ] characters ^(?:[A-Za-z0-9!#$%&'*+/=?^_`{|}~-]+(?:\.[A-Za... The email address of the account holder associated with apple pay. |
object (Phone) The phone number, in its canonical international E.164 numbering plan format. Supports only the | |
object (apple_pay_decrypted_token_data) The decrypted payload details for the apple pay token. | |
vault_id | string (vault_id) [ 1 .. 255 ] characters ^[0-9a-zA-Z_-]+$ The PayPal-generated ID for the saved apple pay payment_source. This ID should be stored on the merchant's server so the saved payment source can be used for future transactions. |
{- "id": "string",
- "stored_credential": {
- "payment_initiator": "CUSTOMER",
- "payment_type": "ONE_TIME",
- "usage": "FIRST",
- "previous_network_transaction_reference": {
- "id": "stringstr",
- "date": "stri",
- "acquirer_reference_number": "string",
- "network": "VISA"
}
}, - "attributes": {
- "customer": {
- "id": "string",
- "email_address": "string",
- "phone": {
- "phone_type": "FAX",
- "phone_number": {
- "national_number": "string"
}
}
}, - "vault": {
- "store_in_vault": "ON_SUCCESS"
}
}, - "name": "string",
- "email_address": "string",
- "phone_number": {
- "national_number": "string"
}, - "decrypted_token": {
- "device_manufacturer_id": "string",
- "payment_data_type": "3DSECURE",
- "transaction_amount": {
- "currency_code": "str",
- "value": "string"
}, - "tokenized_card": {
- "name": "string",
- "number": "stringstrings",
- "expiry": "string",
- "card_type": "VISA",
- "type": "CREDIT",
- "brand": "VISA",
- "billing_address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
}, - "payment_data": {
- "cryptogram": "string",
- "eci_indicator": "string",
- "emv_data": "string",
- "pin": "string"
}
}, - "vault_id": "string"
}
Customizes the payer experience during the approval process for the payment with PayPal.
Note: Partners and Marketplaces might configurebrand_name
andshipping_preference
during partner account setup, which overrides the request values.
brand_name | string [ 1 .. 127 ] characters DEPRECATED. The label that overrides the business name in the PayPal account on the PayPal site. The fields in | ||||||||
landing_page | string (Order Application Context Landing Page) [ 1 .. 13 ] characters ^[0-9A-Z_]+$ Default: "NO_PREFERENCE" DEPRECATED. DEPRECATED. The type of landing page to show on the PayPal site for customer checkout. The fields in
| ||||||||
shipping_preference | string (Order Application Context Shipping Preference) [ 1 .. 20 ] characters ^[0-9A-Z_]+$ Default: "GET_FROM_FILE" DEPRECATED. DEPRECATED. The shipping preference:
application_context are now available in the experience_context object under the payment_source which supports them (eg. payment_source.paypal.experience_context.shipping_preference ). Please specify this field in the experience_context object instead of the application_context object.
| ||||||||
user_action | string [ 1 .. 8 ] characters ^[0-9A-Z_]+$ Default: "CONTINUE" DEPRECATED. Configures a Continue or Pay Now checkout flow. The fields in
| ||||||||
return_url | string <uri> DEPRECATED. The URL where the customer is redirected after the customer approves the payment. The fields in | ||||||||
cancel_url | string <uri> DEPRECATED. The URL where the customer is redirected after the customer cancels the payment. The fields in | ||||||||
locale | string <ppaas_common_language_v3> (language) [ 2 .. 10 ] characters ^[a-z]{2}(?:-[A-Z][a-z]{3})?(?:-(?:[A-Z]{2}|[... DEPRECATED. The BCP 47-formatted locale of pages that the PayPal payment experience shows. PayPal supports a five-character code. For example, | ||||||||
object (payment_method) DEPRECATED. The customer and merchant payment preferences. The fields in | |||||||||
object (stored_payment_source) DEPRECATED. Provides additional details to process a payment using a
stored_payment_source are now available in the stored_credential object under the payment_source which supports them (eg. payment_source.card.stored_credential.payment_initiator ). Please specify this field in the payment_source object instead of the application_context object.
|
{- "brand_name": "string",
- "landing_page": "LOGIN",
- "shipping_preference": "GET_FROM_FILE",
- "user_action": "CONTINUE",
- "locale": "string",
- "payment_method": {
- "standard_entry_class_code": "TEL",
- "payee_preferred": "UNRESTRICTED"
}, - "stored_payment_source": {
- "payment_initiator": "CUSTOMER",
- "payment_type": "ONE_TIME",
- "usage": "FIRST",
- "previous_network_transaction_reference": {
- "id": "stringstr",
- "date": "stri",
- "acquirer_reference_number": "string",
- "network": "VISA"
}
}
}
Information about cardholder possession validation and cardholder identification and verifications (ID&V).
account_verified | boolean Default: false If true, indicates that Cardholder possession validation has been performed on returned payment credential. |
card_holder_authenticated | boolean Default: false If true, indicates that identification and verifications (ID&V) was performed on the returned payment credential.If false, the same risk-based authentication can be performed as you would for card transactions. This risk-based authentication can include, but not limited to, step-up with 3D Secure protocol if applicable. |
{- "account_verified": false,
- "card_holder_authenticated": false
}
Results of Authentication such as 3D Secure.
liability_shift | string (liability_shift) [ 1 .. 255 ] characters ^[0-9A-Z_]+$ Liability shift indicator. The outcome of the issuer's authentication.
| ||||||||
object (three_d_secure_authentication_response) Results of 3D Secure Authentication. |
{- "liability_shift": "NO",
- "three_d_secure": {
- "authentication_status": "Y",
- "enrollment_status": "Y"
}
}
The authorized payment transaction.
status | string (Authorization Status) The status for the authorized payment.
| ||||||||||||||
object (authorization_status_details) The details of the authorized order pending status. | |||||||||||||||
id | string The PayPal-generated ID for the authorized payment. | ||||||||||||||
invoice_id | string The API caller-provided external invoice number for this order. Appears in both the payer's transaction history and the emails that the payer receives. | ||||||||||||||
custom_id | string <= 255 characters The API caller-provided external ID. Used to reconcile API caller-initiated transactions with PayPal transactions. Appears in transaction and settlement reports. | ||||||||||||||
Array of objects (Link Description) An array of related HATEOAS links. | |||||||||||||||
object (Money) The amount for this authorized payment. | |||||||||||||||
object (network_transaction_reference) Reference values used by the card network to identify a transaction. | |||||||||||||||
object (seller_protection) The level of protection offered as defined by PayPal Seller Protection for Merchants. | |||||||||||||||
expiration_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 date and time when the authorized payment expires, in Internet date and time format. | ||||||||||||||
create_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 date and time when the transaction occurred, in Internet date and time format. | ||||||||||||||
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 date and time when the transaction was last updated, in Internet date and time format. |
{- "status": "CREATED",
- "status_details": {
- "reason": "PENDING_REVIEW"
}, - "id": "string",
- "invoice_id": "string",
- "custom_id": "string",
- "links": [
- {
- "href": "string",
- "rel": "string",
- "method": "GET"
}
], - "amount": {
- "currency_code": "str",
- "value": "string"
}, - "network_transaction_reference": {
- "id": "stringstr",
- "date": "stri",
- "acquirer_reference_number": "string",
- "network": "VISA"
}, - "seller_protection": {
- "status": "ELIGIBLE",
- "dispute_categories": [
- "string"
]
}, - "expiration_time": "string",
- "create_time": "stringstringstringst",
- "update_time": "stringstringstringst"
}
The status fields and status details for an authorized payment.
status | string (Authorization Status) The status for the authorized payment.
| ||||||||||||||
object (authorization_status_details) The details of the authorized order pending status. |
{- "status": "CREATED",
- "status_details": {
- "reason": "PENDING_REVIEW"
}
}
The details of the authorized payment status.
reason | string (Authorization Incomplete Reason) [ 1 .. 64 ] characters ^[A-Z_]+$ The reason why the authorized status is
|
{- "reason": "PENDING_REVIEW"
}
The authorization with additional payment details, such as risk assessment and processor response. These details are populated only for certain payment methods.
status | string (Authorization Status) The status for the authorized payment.
| ||||||||||||||
object (authorization_status_details) The details of the authorized order pending status. | |||||||||||||||
id | string The PayPal-generated ID for the authorized payment. | ||||||||||||||
invoice_id | string The API caller-provided external invoice number for this order. Appears in both the payer's transaction history and the emails that the payer receives. | ||||||||||||||
custom_id | string <= 255 characters The API caller-provided external ID. Used to reconcile API caller-initiated transactions with PayPal transactions. Appears in transaction and settlement reports. | ||||||||||||||
Array of objects (Link Description) An array of related HATEOAS links. | |||||||||||||||
object (Money) The amount for this authorized payment. | |||||||||||||||
object (network_transaction_reference) Reference values used by the card network to identify a transaction. | |||||||||||||||
object (seller_protection) The level of protection offered as defined by PayPal Seller Protection for Merchants. | |||||||||||||||
expiration_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 date and time when the authorized payment expires, in Internet date and time format. | ||||||||||||||
create_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 date and time when the transaction occurred, in Internet date and time format. | ||||||||||||||
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 date and time when the transaction was last updated, in Internet date and time format. | ||||||||||||||
object (processor_response) The processor response information for payment requests, such as direct credit card transactions. |
{- "status": "CREATED",
- "status_details": {
- "reason": "PENDING_REVIEW"
}, - "id": "string",
- "invoice_id": "string",
- "custom_id": "string",
- "links": [
- {
- "href": "string",
- "rel": "string",
- "method": "GET"
}
], - "amount": {
- "currency_code": "str",
- "value": "string"
}, - "network_transaction_reference": {
- "id": "stringstr",
- "date": "stri",
- "acquirer_reference_number": "string",
- "network": "VISA"
}, - "seller_protection": {
- "status": "ELIGIBLE",
- "dispute_categories": [
- "string"
]
}, - "expiration_time": "string",
- "create_time": "stringstringstringst",
- "update_time": "stringstringstringst",
- "processor_response": {
- "avs_code": "A",
- "cvv_code": "E",
- "response_code": "0000",
- "payment_advice_code": "01"
}
}
Information used to pay Bancontact.
card_last_digits | string = 4 characters [0-9]{4} The last digits of the card used to fund the Bancontact payment. |
name | string (name) [ 3 .. 300 ] characters The name of the account holder associated with this payment method. |
country_code | string <ppaas_common_country_code_v2> (country_code) = 2 characters ^([A-Z]{2}|C2)$ The two-character ISO 3166-1 country code. |
bic | string (BIC) [ 8 .. 11 ] characters ^[A-Z-a-z0-9]{4}[A-Z-a-z]{2}[A-Z-a-z0-9]{2}([... The bank identification code (BIC). |
iban_last_chars | string (iban_last_chars) [ 4 .. 34 ] characters [a-zA-Z0-9]{4} The last characters of the IBAN used to pay. |
{- "card_last_digits": "stri",
- "name": "string",
- "country_code": "string",
- "bic": "string",
- "iban_last_chars": "string"
}
Information needed to pay using Bancontact.
name required | string (name) [ 3 .. 300 ] characters The name of the account holder associated with this payment method. |
country_code required | string <ppaas_common_country_code_v2> (country_code) = 2 characters ^([A-Z]{2}|C2)$ The two-character ISO 3166-1 country code. |
object (experience_context_base) Customizes the payer experience during the approval process for the payment. |
{- "name": "string",
- "country_code": "string",
- "experience_context": {
- "brand_name": "string",
- "shipping_preference": "GET_FROM_FILE",
- "locale": "string",
- "return_url": "string",
- "cancel_url": "string"
}
}
The business identification code (BIC). In payments systems, a BIC is used to identify a specific business, most commonly a bank.
The business identification code (BIC). In payments systems, a BIC is used to identify a specific business, most commonly a bank.
"stringst"
The PayPal billing agreement ID. References an approved recurring payment for goods or services.
The PayPal billing agreement ID. References an approved recurring payment for goods or services.
"string"
Bank Identification Number (BIN) details used to fund a payment.
bin | string [ 1 .. 25 ] characters ^[0-9]+$ The Bank Identification Number (BIN) signifies the number that is being used to identify the granular level details (except the PII information) of the card. |
issuing_bank | string [ 1 .. 64 ] characters The issuer of the card instrument. |
products | Array of strings [ 1 .. 256 ] items The type of card product assigned to the BIN by the issuer. These values are defined by the issuer and may change over time. Some examples include: PREPAID_GIFT, CONSUMER, CORPORATE. |
bin_country_code | string <ppaas_common_country_code_v2> (country_code) = 2 characters ^([A-Z]{2}|C2)$ The two-character ISO-3166-1 country code of the bank. |
{- "bin": "string",
- "issuing_bank": "string",
- "products": [
- "string"
], - "bin_country_code": "string"
}
Information used to pay using BLIK.
name | string (name) [ 3 .. 300 ] characters The name of the account holder associated with this payment method. |
country_code | string <ppaas_common_country_code_v2> (country_code) = 2 characters ^([A-Z]{2}|C2)$ The two-character ISO 3166-1 country code. |
string <ppaas_common_email_address_v2> (email_address) [ 3 .. 254 ] characters ^(?:[A-Za-z0-9!#$%&'*+/=?^_`{|}~-]+(?:\.[A-Za... The email address of the account holder associated with this payment method. | |
object (blik_one_click_response) The one-click integration flow object. |
{- "name": "string",
- "country_code": "string",
- "email": "string",
- "one_click": {
- "consumer_reference": "string"
}
}
Customizes the payer experience during the approval process for the BLIK payment.
brand_name | string [ 1 .. 127 ] characters ^.*$ 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. | ||||||||
shipping_preference | string [ 1 .. 24 ] characters ^[A-Z_]+$ Default: "GET_FROM_FILE" The location from which the shipping address is derived.
| ||||||||
locale | string <ppaas_common_language_v3> (language) [ 2 .. 10 ] characters ^[a-z]{2}(?:-[A-Z][a-z]{3})?(?:-(?:[A-Z]{2}|[... The BCP 47-formatted locale of pages that the PayPal payment experience shows. PayPal supports a five-character code. For example, | ||||||||
return_url | string <uri> (url) The URL where the customer is redirected after the customer approves the payment. | ||||||||
cancel_url | string <uri> (url) The URL where the customer is redirected after the customer cancels the payment. | ||||||||
consumer_user_agent | string [ 1 .. 256 ] characters ^.*$ The payer's User Agent. For example, Mozilla/5.0 (Macintosh; Intel Mac OS X x.y; rv:42.0). | ||||||||
consumer_ip | string <ppaas_ip_address_v1> (IP Address) [ 7 .. 39 ] characters ^(([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[... The IP address of the consumer. It could be either IPv4 or IPv6. |
{- "brand_name": "string",
- "shipping_preference": "GET_FROM_FILE",
- "locale": "string",
- "return_url": "string",
- "cancel_url": "string",
- "consumer_user_agent": "string",
- "consumer_ip": "string"
}
Information used to pay using BLIK level_0 flow.
auth_code required | string = 6 characters ^[0-9]{6}$ The 6-digit code used to authenticate a consumer within BLIK. |
{- "auth_code": "string"
}
Information used to pay using BLIK one-click flow.
auth_code | string = 6 characters ^[0-9]{6}$ The 6-digit code used to authenticate a consumer within BLIK. |
consumer_reference required | string [ 3 .. 64 ] characters ^[ -~]{3,64}$ The merchant generated, unique reference serving as a primary identifier for accounts connected between Blik and a merchant. |
alias_label | string [ 8 .. 35 ] characters ^[ -~]{8,35}$ A bank defined identifier used as a display name to allow the payer to differentiate between multiple registered bank accounts. |
alias_key | string [ 1 .. 19 ] characters ^[0-9]+$ A Blik-defined identifier for a specific Blik-enabled bank account that is associated with a given merchant. Used only in conjunction with a Consumer Reference. |
{- "auth_code": "string",
- "consumer_reference": "string",
- "alias_label": "stringst",
- "alias_key": "string"
}
Information used to pay using BLIK one-click flow.
consumer_reference | string [ 3 .. 64 ] characters ^[ -~]{3,64}$ The merchant generated, unique reference serving as a primary identifier for accounts connected between Blik and a merchant. |
{- "consumer_reference": "string"
}
Information needed to pay using BLIK.
name required | string (name) [ 3 .. 300 ] characters The name of the account holder associated with this payment method. |
country_code required | string <ppaas_common_country_code_v2> (country_code) = 2 characters ^([A-Z]{2}|C2)$ The two-character ISO 3166-1 country code. |
string <ppaas_common_email_address_v2> (email_address) [ 3 .. 254 ] characters ^(?:[A-Za-z0-9!#$%&'*+/=?^_`{|}~-]+(?:\.[A-Za... The email address of the account holder associated with this payment method. | |
object (blik_experience_context) Customizes the payer experience during the approval process for the payment. | |
object (blik_level_0) The level_0 integration flow object. | |
object (blik_one_click) The one-click integration flow object. |
{- "name": "string",
- "country_code": "string",
- "email": "string",
- "experience_context": {
- "brand_name": "string",
- "shipping_preference": "GET_FROM_FILE",
- "locale": "string",
- "return_url": "string",
- "cancel_url": "string",
- "consumer_user_agent": "string",
- "consumer_ip": "string"
}, - "level_0": {
- "auth_code": "string"
}, - "one_click": {
- "auth_code": "string",
- "consumer_reference": "string",
- "alias_label": "stringst",
- "alias_key": "string"
}
}
A captured payment.
status | string (Capture Status) The status of the captured payment.
| ||||||||||||||
object (capture_status_details) The details of the captured payment status. | |||||||||||||||
id | string The PayPal-generated ID for the captured payment. | ||||||||||||||
invoice_id | string The API caller-provided external invoice number for this order. Appears in both the payer's transaction history and the emails that the payer receives. | ||||||||||||||
custom_id | string <= 255 characters The API caller-provided external ID. Used to reconcile API caller-initiated transactions with PayPal transactions. Appears in transaction and settlement reports. | ||||||||||||||
final_capture | boolean Default: false Indicates whether you can make additional captures against the authorized payment. Set to | ||||||||||||||
disbursement_mode | string (disbursement_mode) [ 1 .. 16 ] characters ^[A-Z_]+$ Default: "INSTANT" The funds that are held on behalf of the merchant.
| ||||||||||||||
Array of objects (Link Description) An array of related HATEOAS links. | |||||||||||||||
object (Money) The amount for this captured payment. | |||||||||||||||
object (network_transaction_reference) Reference values used by the card network to identify a transaction. | |||||||||||||||
object (seller_protection) The level of protection offered as defined by PayPal Seller Protection for Merchants. | |||||||||||||||
object (Seller Receivable Breakdown) The detailed breakdown of the capture activity. This is not available for transactions that are in pending state. | |||||||||||||||
object (processor_response) An object that provides additional processor information for a direct credit card transaction. | |||||||||||||||
create_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 date and time when the transaction occurred, in Internet date and time format. | ||||||||||||||
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 date and time when the transaction was last updated, in Internet date and time format. |
{- "status": "COMPLETED",
- "status_details": {
- "reason": "BUYER_COMPLAINT"
}, - "id": "string",
- "invoice_id": "string",
- "custom_id": "string",
- "final_capture": false,
- "disbursement_mode": "INSTANT",
- "links": [
- {
- "href": "string",
- "rel": "string",
- "method": "GET"
}
], - "amount": {
- "currency_code": "str",
- "value": "string"
}, - "network_transaction_reference": {
- "id": "stringstr",
- "date": "stri",
- "acquirer_reference_number": "string",
- "network": "VISA"
}, - "seller_protection": {
- "status": "ELIGIBLE",
- "dispute_categories": [
- "string"
]
}, - "seller_receivable_breakdown": {
- "platform_fees": [
- {
- "amount": {
- "currency_code": "str",
- "value": "string"
}, - "payee": {
- "email_address": "string",
- "merchant_id": "stringstrings"
}
}
], - "gross_amount": {
- "currency_code": "str",
- "value": "string"
}, - "paypal_fee": {
- "currency_code": "str",
- "value": "string"
}, - "paypal_fee_in_receivable_currency": {
- "currency_code": "str",
- "value": "string"
}, - "net_amount": {
- "currency_code": "str",
- "value": "string"
}, - "receivable_amount": {
- "currency_code": "str",
- "value": "string"
}, - "exchange_rate": {
- "value": "string",
- "source_currency": "str",
- "target_currency": "str"
}
}, - "processor_response": {
- "avs_code": "A",
- "cvv_code": "E",
- "response_code": "0000",
- "payment_advice_code": "01"
}, - "create_time": "stringstringstringst",
- "update_time": "stringstringstringst"
}
The status and status details of a captured payment.
status | string (Capture Status) The status of the captured payment.
| ||||||||||||||
object (capture_status_details) The details of the captured payment status. |
{- "status": "COMPLETED",
- "status_details": {
- "reason": "BUYER_COMPLAINT"
}
}
The details of the captured payment status.
reason | string (Capture Incomplete Reason) [ 1 .. 64 ] characters ^[A-Z_]+$ The reason why the captured payment status is
|
{- "reason": "BUYER_COMPLAINT"
}
The payment card to use to fund a payment. Can be a credit or debit card.
name | string [ 1 .. 300 ] characters ^.{1,300}$ The card holder's name as it appears on the card. |
number | string [ 13 .. 19 ] characters ^[0-9]{13,19}$ The primary account number (PAN) for the payment card. |
security_code | string [ 3 .. 4 ] characters ^[0-9]{3,4}$ 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 |
expiry | string (date_year_month) = 7 characters ^[0-9]{4}-(0[1-9]|1[0-2])$ The card expiration year and month, in Internet date format. |
object (Portable Postal Address (Medium-Grained)) The billing address for this card. Supports only the | |
object (card_attributes) Additional attributes associated with the use of this card. |
{- "name": "string",
- "number": "stringstrings",
- "security_code": "stri",
- "expiry": "string",
- "billing_address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}, - "attributes": {
- "customer": {
- "id": "string",
- "email_address": "string",
- "phone": {
- "phone_type": "FAX",
- "phone_number": {
- "national_number": "string"
}
}, - "merchant_customer_id": "string"
}, - "vault": {
- "store_in_vault": "ON_SUCCESS"
}, - "verification": {
- "method": "SCA_ALWAYS"
}
}
}
The payment card to use to fund a payment. Can be a credit or debit card.
name | string [ 1 .. 300 ] characters ^.{1,300}$ The card holder's name as it appears on the card. | ||||||||||||||||||||||||||||||||||||||||||||||||||||
number | string [ 13 .. 19 ] characters ^[0-9]{13,19}$ The primary account number (PAN) for the payment card. | ||||||||||||||||||||||||||||||||||||||||||||||||||||
expiry | string (date_year_month) = 7 characters ^[0-9]{4}-(0[1-9]|1[0-2])$ The card expiration year and month, in Internet date format. | ||||||||||||||||||||||||||||||||||||||||||||||||||||
card_type | string (card_brand) [ 1 .. 255 ] characters ^[A-Z_]+$ The card brand or network. Typically used in the response.
| ||||||||||||||||||||||||||||||||||||||||||||||||||||
type | string (card_type) [ 1 .. 255 ] characters ^[A-Z_]+$ The payment card type.
| ||||||||||||||||||||||||||||||||||||||||||||||||||||
brand | string (card_brand) [ 1 .. 255 ] characters ^[A-Z_]+$ The card brand or network. Typically used in the response.
| ||||||||||||||||||||||||||||||||||||||||||||||||||||
object (Portable Postal Address (Medium-Grained)) The billing address for this card. Supports only the |
{- "name": "string",
- "number": "stringstrings",
- "expiry": "string",
- "card_type": "VISA",
- "type": "CREDIT",
- "brand": "VISA",
- "billing_address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
}
The API caller can opt in to verify the card through PayPal offered verification services (e.g. Smart Dollar Auth, 3DS).
method | string [ 1 .. 255 ] characters ^[0-9A-Z_]+$ Default: "SCA_WHEN_REQUIRED" The method used for card verification.
|
{- "method": "SCA_ALWAYS"
}
Additional attributes associated with the use of this card.
object (card_customer) The details about a customer in PayPal's system of record. | |
object (vault_instruction_base) Instruction to vault the card based on the specified strategy. | |
object (Card Verification) Instruction to optionally verify the card based on the specified strategy. |
{- "customer": {
- "id": "string",
- "email_address": "string",
- "phone": {
- "phone_type": "FAX",
- "phone_number": {
- "national_number": "string"
}
}, - "merchant_customer_id": "string"
}, - "vault": {
- "store_in_vault": "ON_SUCCESS"
}, - "verification": {
- "method": "SCA_ALWAYS"
}
}
Additional attributes associated with the use of this card.
object (Card Verification) Instruction to optionally verify the card based on the specified strategy. |
{- "verification": {
- "method": "SCA_ALWAYS"
}
}
Additional attributes associated with the use of this card.
object (card_vault_response) The details about a saved Card payment source. |
{- "vault": {
- "id": "string",
- "status": "VAULTED",
- "links": [
- {
- "href": "string",
- "rel": "string",
- "method": "GET"
}
], - "customer": {
- "id": "string",
- "email_address": "string",
- "phone": {
- "phone_type": "FAX",
- "phone_number": {
- "national_number": "string"
}
}, - "merchant_customer_id": "string"
}
}
}
The card network or brand. Applies to credit, debit, gift, and payment cards.
The card network or brand. Applies to credit, debit, gift, and payment cards.
Enum: | Description |
---|---|
VISA | Visa card. |
MASTERCARD | Mastecard card. |
DISCOVER | Discover card. |
AMEX | American Express card. |
SOLO | Solo debit card. |
JCB | Japan Credit Bureau card. |
STAR | Military Star card. |
DELTA | Delta Airlines card. |
SWITCH | Switch credit card. |
MAESTRO | Maestro credit card. |
CB_NATIONALE | Carte Bancaire (CB) credit card. |
CONFIGOGA | Configoga credit card. |
CONFIDIS | Confidis credit card. |
ELECTRON | Visa Electron credit card. |
CETELEM | Cetelem credit card. |
CHINA_UNION_PAY | China union pay credit card. |
DINERS | The Diners Club International banking and payment services capability network owned by Discover Financial Services (DFS), one of the most recognized brands in US financial services. |
ELO | The Brazilian Elo card payment network. |
HIPER | The Hiper - Ingenico ePayment network. |
HIPERCARD | The Brazilian Hipercard payment network that's widely accepted in the retail market. |
RUPAY | The RuPay payment network. |
GE | The GE Credit Union 3Point card payment network. |
SYNCHRONY | The Synchrony Financial (SYF) payment network. |
EFTPOS | The Electronic Fund Transfer At Point of Sale(EFTPOS) Debit card payment network. |
UNKNOWN | UNKNOWN payment network. |
"VISA"
The details about a customer in PayPal's system of record.
id | string (merchant_partner_customer_id) [ 1 .. 22 ] characters ^[0-9a-zA-Z_-]+$ The unique ID for a customer generated by PayPal. |
email_address | string <merchant_common_email_address_v2> (email) [ 3 .. 254 ] characters (?:[a-zA-Z0-9!#$%&'*+/=?^_`{|}~-]+(?:\.[a-zA-... Email address of the buyer as provided to the merchant or on file with the merchant. Email Address is required if you are processing the transaction using PayPal Guest Processing which is offered to select partners and merchants. For all other use cases we do not expect partners/merchant to send email_address of their customer. |
object (phone_with_type) The phone number of the buyer as provided to the merchant or on file with the merchant. The | |
merchant_customer_id | string [ 1 .. 64 ] characters ^[0-9a-zA-Z-_.^*$@#]+$ Merchants and partners may already have a data-store where their customer information is persisted. Use merchant_customer_id to associate the PayPal-generated customer.id to your representation of a customer. |
{- "id": "string",
- "email_address": "string",
- "phone": {
- "phone_type": "FAX",
- "phone_number": {
- "national_number": "string"
}
}, - "merchant_customer_id": "string"
}
Customizes the payer experience during the 3DS Approval for payment.
return_url | string <uri> (url) [ 10 .. 4000 ] characters The URL where the customer will be redirected upon successfully completing the 3DS challenge. |
cancel_url | string <uri> (url) [ 10 .. 4000 ] characters The URL where the customer will be redirected upon cancelling the 3DS challenge. |
{- "return_url": "string",
- "cancel_url": "string"
}
Representation of card details as received in the request.
last_digits | string [ 2 .. 4 ] characters [0-9]{2,} The last digits of the payment card. |
expiry | string (date_year_month) = 7 characters ^[0-9]{4}-(0[1-9]|1[0-2])$ The card expiration year and month, in Internet date format. |
{- "last_digits": "stri",
- "expiry": "string"
}
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.
name | string [ 1 .. 300 ] characters ^.{1,300}$ The card holder's name as it appears on the card. |
number | string [ 13 .. 19 ] characters ^[0-9]{13,19}$ The primary account number (PAN) for the payment card. |
security_code | string [ 3 .. 4 ] characters ^[0-9]{3,4}$ 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 |
expiry | string (date_year_month) = 7 characters ^[0-9]{4}-(0[1-9]|1[0-2])$ The card expiration year and month, in Internet date format. |
object (Portable Postal Address (Medium-Grained)) The billing address for this card. Supports only the | |
object (card_attributes) Additional attributes associated with the use of this card. | |
object (card_stored_credential) Provides additional details to process a payment using a
| |
vault_id | string (vault_id) [ 1 .. 255 ] characters ^[0-9a-zA-Z_-]+$ The PayPal-generated ID for the saved card payment source. Typically stored on the merchant's server. |
single_use_token | string (single_use_token) [ 1 .. 255 ] characters ^[0-9a-zA-Z_-]+$ The PayPal-generated, short-lived, one-time-use token, used to communicate payment information to PayPal for transaction processing. |
object (network_token) A 3rd party network token refers to a network token that the merchant provisions from and vaults with an external TSP (Token Service Provider) other than PayPal. | |
object (card_experience_context) Customizes the payer experience during the 3DS Approval for payment. |
{- "name": "string",
- "number": "stringstrings",
- "security_code": "stri",
- "expiry": "string",
- "billing_address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}, - "attributes": {
- "customer": {
- "id": "string",
- "email_address": "string",
- "phone": {
- "phone_type": "FAX",
- "phone_number": {
- "national_number": "string"
}
}, - "merchant_customer_id": "string"
}, - "vault": {
- "store_in_vault": "ON_SUCCESS"
}, - "verification": {
- "method": "SCA_ALWAYS"
}
}, - "stored_credential": {
- "payment_initiator": "CUSTOMER",
- "payment_type": "ONE_TIME",
- "usage": "FIRST",
- "previous_network_transaction_reference": {
- "id": "stringstr",
- "date": "stri",
- "acquirer_reference_number": "string",
- "network": "VISA"
}
}, - "vault_id": "string",
- "single_use_token": "string",
- "network_token": {
- "number": "stringstrings",
- "cryptogram": "stringstringstringstringstri",
- "token_requestor_id": "string",
- "expiry": "string",
- "eci_flag": "MASTERCARD_NON_3D_SECURE_TRANSACTION"
}, - "experience_context": {
- "return_url": "string",
- "cancel_url": "string"
}
}
The payment card to use to fund a payment. Card can be a credit or debit card.
name | string [ 2 .. 300 ] characters The card holder's name as it appears on the card. | ||||||||||||||||||||||||||||||||||||||||||||||||||||
last_digits | string[0-9]{2,} The last digits of the payment card. | ||||||||||||||||||||||||||||||||||||||||||||||||||||
available_networks | Array of strings (card_brand) [ 1 .. 256 ] items Array of brands or networks associated with the card.
| ||||||||||||||||||||||||||||||||||||||||||||||||||||
object (card_from_request) Representation of card details as received in the request. | |||||||||||||||||||||||||||||||||||||||||||||||||||||
brand | string (card_brand) [ 1 .. 255 ] characters ^[A-Z_]+$ The card brand or network. Typically used in the response.
| ||||||||||||||||||||||||||||||||||||||||||||||||||||
type | string (card_type) [ 1 .. 255 ] characters ^[A-Z_]+$ The payment card type.
| ||||||||||||||||||||||||||||||||||||||||||||||||||||
object (authentication_response) Results of Authentication such as 3D Secure. | |||||||||||||||||||||||||||||||||||||||||||||||||||||
object (card_attributes_response) Additional attributes associated with the use of this card. | |||||||||||||||||||||||||||||||||||||||||||||||||||||
expiry | string (date_year_month) = 7 characters ^[0-9]{4}-(0[1-9]|1[0-2])$ The card expiration year and month, in Internet date format. | ||||||||||||||||||||||||||||||||||||||||||||||||||||
object (bin_details) Bank Identification Number (BIN) details used to fund a payment. |
{- "name": "string",
- "last_digits": "string",
- "available_networks": [
- "VISA"
], - "from_request": {
- "last_digits": "stri",
- "expiry": "string"
}, - "brand": "VISA",
- "type": "CREDIT",
- "authentication_result": {
- "liability_shift": "NO",
- "three_d_secure": {
- "authentication_status": "Y",
- "enrollment_status": "Y"
}
}, - "attributes": {
- "vault": {
- "id": "string",
- "status": "VAULTED",
- "links": [
- {
- "href": "string",
- "rel": "string",
- "method": "GET"
}
], - "customer": {
- "id": "string",
- "email_address": "string",
- "phone": {
- "phone_type": "FAX",
- "phone_number": {
- "national_number": "string"
}
}, - "merchant_customer_id": "string"
}
}
}, - "expiry": "string",
- "bin_details": {
- "bin": "string",
- "issuing_bank": "string",
- "products": [
- "string"
], - "bin_country_code": "string"
}
}
The payment card to use to fund a payment. Card can be a credit or debit card.
name | string [ 2 .. 300 ] characters The card holder's name as it appears on the card. | ||||||||||||||||||||||||||||||||||||||||||||||||||||
last_digits | string[0-9]{2,} The last digits of the payment card. | ||||||||||||||||||||||||||||||||||||||||||||||||||||
available_networks | Array of strings (card_brand) [ 1 .. 256 ] items Array of brands or networks associated with the card.
| ||||||||||||||||||||||||||||||||||||||||||||||||||||
object (card_from_request) Representation of card details as received in the request. | |||||||||||||||||||||||||||||||||||||||||||||||||||||
brand | string (card_brand) [ 1 .. 255 ] characters ^[A-Z_]+$ The card brand or network. Typically used in the response.
| ||||||||||||||||||||||||||||||||||||||||||||||||||||
type | string (card_type) [ 1 .. 255 ] characters ^[A-Z_]+$ The payment card type.
| ||||||||||||||||||||||||||||||||||||||||||||||||||||
object (authentication_response) Results of Authentication such as 3D Secure. | |||||||||||||||||||||||||||||||||||||||||||||||||||||
object (card_attributes_response) Additional attributes associated with the use of this card. | |||||||||||||||||||||||||||||||||||||||||||||||||||||
expiry | string (date_year_month) = 7 characters ^[0-9]{4}-(0[1-9]|1[0-2])$ The card expiration year and month, in Internet date format. | ||||||||||||||||||||||||||||||||||||||||||||||||||||
object (bin_details) Bank Identification Number (BIN) details used to fund a payment. |
{- "name": "string",
- "last_digits": "string",
- "available_networks": [
- "VISA"
], - "from_request": {
- "last_digits": "stri",
- "expiry": "string"
}, - "brand": "VISA",
- "type": "CREDIT",
- "authentication_result": {
- "liability_shift": "NO",
- "three_d_secure": {
- "authentication_status": "Y",
- "enrollment_status": "Y"
}
}, - "attributes": {
- "vault": {
- "id": "string",
- "status": "VAULTED",
- "links": [
- {
- "href": "string",
- "rel": "string",
- "method": "GET"
}
], - "customer": {
- "id": "string",
- "email_address": "string",
- "phone": {
- "phone_type": "FAX",
- "phone_number": {
- "national_number": "string"
}
}, - "merchant_customer_id": "string"
}
}
}, - "expiry": "string",
- "bin_details": {
- "bin": "string",
- "issuing_bank": "string",
- "products": [
- "string"
], - "bin_country_code": "string"
}
}
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
.previous_transaction_reference
and previous_network_transaction_reference
- can be present in the request.payment_initiator required | string (payment_initiator) [ 1 .. 255 ] characters ^[0-9A-Z_]+$ The person or party who initiated or triggered the payment.
| ||||||||
payment_type required | string (stored_payment_source_payment_type) [ 1 .. 255 ] characters ^[0-9A-Z_]+$ Indicates the type of the stored payment_source payment.
| ||||||||
usage | string (stored_payment_source_usage_type) [ 1 .. 255 ] characters ^[0-9A-Z_]+$ Default: "DERIVED" Indicates if this is a
| ||||||||
object (network_transaction_reference) Reference values used by the card network to identify a transaction. |
{- "payment_initiator": "CUSTOMER",
- "payment_type": "ONE_TIME",
- "usage": "FIRST",
- "previous_network_transaction_reference": {
- "id": "stringstr",
- "date": "stri",
- "acquirer_reference_number": "string",
- "network": "VISA"
}
}
Merchants and partners can add Level 2 and 3 data to payments to reduce risk and payment processing costs. For more information about processing payments, see checkout or multiparty checkout.
object (level_2) The level 2 card processing data collections. If your merchant account has been configured for Level 2 processing this field will be passed to the processor on your behalf. Please contact your PayPal Technical Account Manager to define level 2 data for your business. | |
object (level_3) The level 3 card processing data collections, If your merchant account has been configured for Level 3 processing this field will be passed to the processor on your behalf. Please contact your PayPal Technical Account Manager to define level 3 data for your business. |
{- "level_2": {
- "invoice_id": "string",
- "tax_total": {
- "currency_code": "str",
- "value": "string"
}
}, - "level_3": {
- "ships_from_postal_code": "string",
- "line_items": [
- {
- "name": "string",
- "quantity": "string",
- "description": "string",
- "sku": "string",
- "upc": {
- "type": "UPC-A",
- "code": "string"
}, - "commodity_code": "string",
- "unit_of_measure": "string",
- "unit_amount": {
- "currency_code": "str",
- "value": "string"
}, - "tax": {
- "currency_code": "str",
- "value": "string"
}, - "discount_amount": {
- "currency_code": "str",
- "value": "string"
}, - "total_amount": {
- "currency_code": "str",
- "value": "string"
}
}
], - "shipping_amount": {
- "currency_code": "str",
- "value": "string"
}, - "duty_amount": {
- "currency_code": "str",
- "value": "string"
}, - "discount_amount": {
- "currency_code": "str",
- "value": "string"
}, - "shipping_address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
}
}
Type of card. i.e Credit, Debit and so on.
Type of card. i.e Credit, Debit and so on.
Enum: | Description |
---|---|
CREDIT | A credit card. |
DEBIT | A debit card. |
PREPAID | A Prepaid card. |
STORE | A store card. |
UNKNOWN | Card type cannot be determined. |
"CREDIT"
The details about a saved Card payment source.
id | string [ 1 .. 255 ] characters The PayPal-generated ID for the saved payment source. | ||||||||
status | string (Vault Status) [ 1 .. 255 ] characters ^[0-9A-Z_]+$ The vault status.
| ||||||||
Array of objects (Link Description) [ 1 .. 10 ] items An array of request-related HATEOAS links. | |||||||||
object (card_customer) The details about a customer in PayPal's system of record. |
{- "id": "string",
- "status": "VAULTED",
- "links": [
- {
- "href": "string",
- "rel": "string",
- "method": "GET"
}
], - "customer": {
- "id": "string",
- "email_address": "string",
- "phone": {
- "phone_type": "FAX",
- "phone_number": {
- "national_number": "string"
}
}, - "merchant_customer_id": "string"
}
}
The carrier for the shipment. Some carriers have a global version as well as local subsidiaries. The subsidiaries are repeated over many countries and might also have an entry in the global list. Choose the carrier for your country. If the carrier is not available for your country, choose the global version of the carrier. If your carrier name is not in the list, set carrier
to OTHER
and set carrier name in carrier_name_other
. For allowed values, see Carriers.
The carrier for the shipment. Some carriers have a global version as well as local subsidiaries. The subsidiaries are repeated over many countries and might also have an entry in the global list. Choose the carrier for your country. If the carrier is not available for your country, choose the global version of the carrier. If your carrier name is not in the list, set carrier
to OTHER
and set carrier name in carrier_name_other
. For allowed values, see Carriers.
Enum: | Description |
---|---|
DPD_RU | |
BG_BULGARIAN_POST | |
KR_KOREA_POST | |
ZA_COURIERIT | |
FR_EXAPAQ | |
ARE_EMIRATES_POST | |
GAC | GAC. |
GEIS | |
SF_EX | |
PAGO | |
MYHERMES | |
DIAMOND_EUROGISTICS | |
CORPORATECOURIERS_WEBHOOK | |
BOND | |
OMNIPARCEL | |
SK_POSTA | |
PUROLATOR | |
FETCHR_WEBHOOK | |
THEDELIVERYGROUP | |
CELLO_SQUARE | |
TARRIVE | |
COLLIVERY | |
MAINFREIGHT | |
IND_FIRSTFLIGHT | |
ACSWORLDWIDE | |
AMSTAN | |
OKAYPARCEL | |
ENVIALIA_REFERENCE | |
SEUR_ES | |
CONTINENTAL | |
FDSEXPRESS | |
AMAZON_FBA_SWISHIP | |
WYNGS | |
DHL_ACTIVE_TRACING | |
ZYLLEM | |
RUSTON | |
XPOST | |
CORREOS_ES | |
DHL_FR | |
PAN_ASIA | |
BRT_IT | |
SRE_KOREA | |
SPEEDEE | |
TNT_UK | |
VENIPAK | |
SHREENANDANCOURIER | |
CROSHOT | |
NIPOST_NG | |
EPST_GLBL | |
NEWGISTICS | |
POST_SLOVENIA | |
JERSEY_POST | |
BOMBINOEXP | |
WMG | |
XQ_EXPRESS | |
FURDECO | |
LHT_EXPRESS | |
SOUTH_AFRICAN_POST_OFFICE | |
SPOTON | |
DIMERCO | |
CYPRUS_POST_CYP | |
ABCUSTOM | |
IND_DELIVREE | |
CN_BESTEXPRESS | |
DX_SFTP | |
PICKUPP_MYS | |
FMX | FMX. |
HELLMANN | |
SHIP_IT_ASIA | |
KERRY_ECOMMERCE | |
FRETERAPIDO | |
PITNEY_BOWES | |
XPRESSEN_DK | |
SEUR_SP_API | |
DELIVERYONTIME | |
JINSUNG | |
TRANS_KARGO | |
SWISHIP_DE | |
IVOY_WEBHOOK | |
AIRMEE_WEBHOOK | |
DHL_BENELUX | |
FIRSTMILE | |
FASTWAY_IR | |
HH_EXP | |
MYS_MYPOST_ONLINE | |
TNT_NL | |
TIPSA | |
TAQBIN_MY | |
KGMHUB | |
INTEXPRESS | |
OVERSE_EXP | |
ONECLICK | |
ROADRUNNER_FREIGHT | |
GLS_CROTIA | |
MRW_FTP | |
BLUEX | |
DYLT | |
DPD_IR | |
SIN_GLBL | |
TUFFNELLS_REFERENCE | |
CJPACKET | |
MILKMAN | |
ASIGNA | |
ONEWORLDEXPRESS | |
ROYAL_MAIL | |
VIA_EXPRESS | |
TIGFREIGHT | |
ZTO_EXPRESS | |
TWO_GO | |
IML | |
INTEL_VALLEY | |
EFS | |
UK_UK_MAIL | |
RAM | |
ALLIEDEXPRESS | |
APC_OVERNIGHT | |
SHIPPIT | |
TFM | |
M_XPRESS | |
HDB_BOX | |
CLEVY_LINKS | |
IBEONE | |
FIEGE_NL | |
KWE_GLOBAL | |
CTC_EXPRESS | |
LAO_POST | |
AMAZON | |
MORE_LINK | |
JX | |
EASY_MAIL | |
ADUIEPYLE | |
GB_PANTHER | |
EXPRESSSALE | |
SG_DETRACK | |
TRUNKRS_WEBHOOK | |
MATDESPATCH | |
DICOM | |
MBW | |
KHM_CAMBODIA_POST | |
SINOTRANS | |
BRT_IT_PARCELID | |
DHL_SUPPLY_CHAIN | |
DHL_PL | |
TOPYOU | |
PALEXPRESS | |
DHL_SG | |
CN_WEDO | |
FULFILLME | |
DPD_DELISTRACK | |
UPS_REFERENCE | |
CARIBOU | |
LOCUS_WEBHOOK | |
DSV | |
CN_GOFLY | |
P2P_TRC | |
DIRECTPARCELS | |
NOVA_POSHTA_INT | |
FEDEX_POLAND | |
CN_JCEX | |
FAR_INTERNATIONAL | |
IDEXPRESS | |
GANGBAO | |
NEWAY | |
POSTNL_INT_3_S | |
RPX_ID | |
DESIGNERTRANSPORT_WEBHOOK | |
GLS_SLOVEN | |
PARCELLED_IN | |
GSI_EXPRESS | |
CON_WAY | |
BROUWER_TRANSPORT | |
CPEX | |
ISRAEL_POST | |
DTDC_IN | |
PTT_POST | |
XDE_WEBHOOK | |
TOLOS | |
GIAO_HANG | |
GEODIS_ESPACE | |
MAGYAR_HU | |
DOORDASH_WEBHOOK | |
TIKI_ID | |
CJ_HK_INTERNATIONAL | |
STAR_TRACK_EXPRESS | |
HELTHJEM | |
SFB2C | |
FREIGHTQUOTE | |
LANDMARK_GLOBAL_REFERENCE | |
PARCEL2GO | |
DELNEXT | |
RCL | |
CGS_EXPRESS | |
HK_POST | |
SAP_EXPRESS | |
PARCELPOST_SG | |
HERMES | |
IND_SAFEEXPRESS | |
TOPHATTEREXPRESS | |
MGLOBAL | |
AVERITT | |
LEADER | |
_2EBOX | |
SG_SPEEDPOST | |
DBSCHENKER_SE | |
ISR_POST_DOMESTIC | |
BESTWAYPARCEL | |
ASENDIA_DE | |
NIGHTLINE_UK | |
TAQBIN_SG | |
TCK_EXPRESS | |
ENDEAVOUR_DELIVERY | |
NANJINGWOYUAN | |
HEPPNER_FR | |
EMPS_CN | |
FONSEN | |
PICKRR | |
APC_OVERNIGHT_CONNUM | |
STAR_TRACK_NEXT_FLIGHT | |
DAJIN | |
UPS_FREIGHT | |
POSTA_PLUS | |
CEVA | |
ANSERX | |
JS_EXPRESS | |
PADTF | |
UPS_MAIL_INNOVATIONS | |
EZSHIP | |
SYPOST | |
AMAZON_SHIP_MCF | |
YUSEN | |
BRING | |
SDA_IT | |
GBA | |
NEWEGGEXPRESS | |
SPEEDCOURIERS_GR | |
FORRUN | |
PICKUP | |
ECMS | |
INTELIPOST | |
FLASHEXPRESS | |
CN_STO | |
SEKO_SFTP | |
HOME_DELIVERY_SOLUTIONS | |
DPD_HGRY | |
KERRYTTC_VN | |
JOYING_BOX | |
TOTAL_EXPRESS | |
ZJS_EXPRESS | |
STARKEN | |
DEMANDSHIP | |
CN_DPEX | DPEX. |
AUPOST_CN | |
LOGISTERS | |
GOGLOBALPOST | |
GLS_CZ | |
PAACK_WEBHOOK | |
GRAB_WEBHOOK | |
PARCELPOINT | |
ICUMULUS | |
DAIGLOBALTRACK | |
GLOBAL_IPARCEL | |
YURTICI_KARGO | |
CN_PAYPAL_PACKAGE | |
PARCEL_2_POST | |
GLS_IT | |
PIL_LOGISTICS | |
HEPPNER | |
GENERAL_OVERNIGHT | |
HAPPY2POINT | |
CHITCHATS | |
SMOOTH | |
CLE_LOGISTICS | |
FIEGE | |
MX_CARGO | |
ZIINGFINALMILE | |
DAYTON_FREIGHT | |
TCS | |
AEX | |
HERMES_DE | |
ROUTIFIC_WEBHOOK | |
GLOBAVEND | |
CJ_LOGISTICS | |
PALLET_NETWORK | |
RAF_PH | |
UK_XDP | |
PAPER_EXPRESS | |
LA_POSTE_SUIVI | |
PAQUETEXPRESS | |
LIEFERY | |
STRECK_TRANSPORT | |
PONY_EXPRESS | |
ALWAYS_EXPRESS | |
GBS_BROKER | |
CITYLINK_MY | |
ALLJOY | |
YODEL | |
YODEL_DIR | |
STONE3PL | |
PARCELPAL_WEBHOOK | |
DHL_ECOMERCE_ASA | |
SIMPLYPOST | |
KY_EXPRESS | |
SHENZHEN | |
US_LASERSHIP | |
UC_EXPRE | |
DIDADI | |
CJ_KR | |
DBSCHENKER_B2B | |
MXE | |
CAE_DELIVERS | |
PFCEXPRESS | |
WHISTL | |
WEPOST | |
DHL_PARCEL_ES | |
DDEXPRESS | |
ARAMEX_AU | |
BNEED | |
HK_TGX | |
LATVIJAS_PASTS | |
VIAEUROPE | |
CORREO_UY | |
CHRONOPOST_FR | |
J_NET | |
_6LS | |
BLR_BELPOST | |
BIRDSYSTEM | |
DOBROPOST | |
WAHANA_ID | |
WEASHIP | |
SONICTL | |
KWT | |
AFLLOG_FTP | |
SKYNET_WORLDWIDE | |
NOVA_POSHTA | |
SEINO | |
SZENDEX | |
BPOST_INT | |
DBSCHENKER_SV | |
AO_DEUTSCHLAND | |
EU_FLEET_SOLUTIONS | |
PCFCORP | |
LINKBRIDGE | |
PRIMAMULTICIPTA | |
COUREX | |
ZAJIL_EXPRESS | |
COLLECTCO | |
JTEXPRESS | |
FEDEX_UK | |
USHIP | |
PIXSELL | |
SHIPTOR | |
CDEK | |
VNM_VIETTELPOST | |
CJ_CENTURY | |
GSO | |
VIWO | |
SKYBOX | |
KERRYTJ | |
NTLOGISTICS_VN | |
SDH_SCM | |
ZINC | |
DPE_SOUTH_AFRC | |
CESKA_CZ | |
ACS_GR | |
DEALERSEND | |
JOCOM | |
CSE | |
TFORCE_FINALMILE | |
SHIP_GATE | |
SHIPTER | |
NATIONAL_SAMEDAY | |
YUNEXPRESS | |
CAINIAO | |
DMS_MATRIX | |
DIRECTLOG | |
ASENDIA_US | |
_3JMSLOGISTICS | |
LICCARDI_EXPRESS | |
SKY_POSTAL | |
CNWANGTONG | |
POSTNORD_LOGISTICS_DK | |
LOGISTIKA | |
CELERITAS | |
PRESSIODE | |
SHREE_MARUTI | |
LOGISTICSWORLDWIDE_HK | |
EFEX | |
LOTTE | |
LONESTAR | |
APRISAEXPRESS | |
BEL_RS | |
OSM_WORLDWIDE | |
WESTGATE_GL | |
FASTRACK | |
DTD_EXPR | |
ALFATREX | |
PROMEDDELIVERY | |
THABIT_LOGISTICS | |
HCT_LOGISTICS | |
CARRY_FLAP | |
US_OLD_DOMINION | |
ANICAM_BOX | |
WANBEXPRESS | |
AN_POST | |
DPD_LOCAL | |
STALLIONEXPRESS | |
RAIDEREX | |
SHOPFANS | |
KYUNGDONG_PARCEL | |
CHAMPION_LOGISTICS | |
PICKUPP_SGP | |
MORNING_EXPRESS | |
NACEX | |
THENILE_WEBHOOK | |
HOLISOL | |
LBCEXPRESS_FTP | |
KURASI | |
USF_REDDAWAY | |
APG | |
CN_BOXC | |
ECOSCOOTING | |
MAINWAY | |
PAPERFLY | |
HOUNDEXPRESS | |
BOX_BERRY | |
EP_BOX | |
PLUS_LOG_UK | |
FULFILLA | |
ASE | |
MAIL_PLUS | |
XPO_LOGISTICS | |
WNDIRECT | |
CLOUDWISH_ASIA | |
ZELERIS | |
GIO_EXPRESS | |
OCS_WORLDWIDE | |
ARK_LOGISTICS | |
AQUILINE | |
PILOT_FREIGHT | |
QWINTRY | |
DANSKE_FRAGT | |
CARRIERS | |
AIR_CANADA_GLOBAL | |
PRESIDENT_TRANS | |
STEPFORWARDFS | |
SKYNET_UK | |
PITTOHIO | |
CORREOS_EXPRESS | |
RL_US | |
MARA_XPRESS | |
DESTINY | |
UK_YODEL | |
COMET_TECH | |
DHL_PARCEL_RU | |
TNT_REFR | |
SHREE_ANJANI_COURIER | |
MIKROPAKKET_BE | |
ETS_EXPRESS | |
COLIS_PRIVE | |
CN_YUNDA | |
AAA_COOPER | |
ROCKET_PARCEL | |
_360LION | |
PANDU | |
PROFESSIONAL_COURIERS | |
FLYTEXPRESS | |
LOGISTICSWORLDWIDE_MY | |
CORREOS_DE_ESPANA | |
IMX | IMX. |
FOUR_PX_EXPRESS | |
XPRESSBEES | |
PICKUPP_VNM | |
STARTRACK_EXPRESS | |
FR_COLISSIMO | |
NACEX_SPAIN_REFERENCE | |
DHL_SUPPLY_CHAIN_AU | |
ESHIPPING | |
SHREETIRUPATI | |
HX_EXPRESS | |
INDOPAKET | |
CN_17POST | |
K1_EXPRESS | |
CJ_GLS | |
MYS_GDEX | |
NATIONEX | |
ANJUN | |
FARGOOD | |
SMG_EXPRESS | |
RZYEXPRESS | |
SEFL | |
TNT_CLICK_IT | |
HDB | |
HIPSHIPPER | |
RPXLOGISTICS | |
KUEHNE | |
IT_NEXIVE | |
PTS | |
SWISS_POST_FTP | |
FASTRK_SERV | |
_4_72 | |
US_YRC | |
POSTNL_INTL_3S | |
ELIAN_POST | |
CUBYN | |
SAU_SAUDI_POST | |
ABXEXPRESS_MY | |
HUAHAN_EXPRESS | |
IND_JAYONEXPRESS | |
ZES_EXPRESS | |
ZEPTO_EXPRESS | |
SKYNET_ZA | |
ZEEK_2_DOOR | |
BLINKLASTMILE | |
POSTA_UKR | |
CHROBINSON | |
CN_POST56 | |
COURANT_PLUS | |
SCUDEX_EXPRESS | |
SHIPENTEGRA | |
B_TWO_C_EUROPE | |
COPE | |
IND_GATI | |
CN_WISHPOST | |
NACEX_ES | |
TAQBIN_HK | |
GLOBALTRANZ | |
HKD | |
BJSHOMEDELIVERY | |
OMNIVA | |
SUTTON | |
PANTHER_REFERENCE | |
SFCSERVICE | |
LTL | |
PARKNPARCEL | |
SPRING_GDS | |
ECEXPRESS | |
INTERPARCEL_AU | |
AGILITY | |
XL_EXPRESS | |
ADERONLINE | |
DIRECTCOURIERS | |
PLANZER | |
SENDING | |
NINJAVAN_WB | |
NATIONWIDE_MY | Nationwide Express Courier Services Bhd (www.nationwide.com.my). |
SENDIT | |
GB_ARROW | |
IND_GOJAVAS | |
KPOST | |
DHL_FREIGHT | |
BLUECARE | |
JINDOUYUN | |
TRACKON | |
GB_TUFFNELLS | |
TRUMPCARD | |
ETOTAL | |
SFPLUS_WEBHOOK | |
SEKOLOGISTICS | |
HERMES_2MANN_HANDLING | |
DPD_LOCAL_REF | |
UDS | |
ZA_SPECIALISED_FREIGHT | |
THA_KERRY | |
PRT_INT_SEUR | |
BRA_CORREIOS | |
NZ_NZ_POST | |
CN_EQUICK | |
MYS_EMS | |
GB_NORSK | |
ESP_MRW | |
ESP_PACKLINK | |
KANGAROO_MY | |
RPX | |
XDP_UK_REFERENCE | |
NINJAVAN_MY | |
ADICIONAL | |
NINJAVAN_ID | |
ROADBULL | |
YAKIT | |
MAILAMERICAS | |
MIKROPAKKET | |
DYNALOGIC | |
DHL_ES | |
DHL_PARCEL_NL | |
DHL_GLOBAL_MAIL_ASIA | |
DAWN_WING | |
GENIKI_GR | |
HERMESWORLD_UK | |
ALPHAFAST | |
BUYLOGIC | |
EKART | |
MEX_SENDA | |
SFC_LOGISTICS | SFC. |
POST_SERBIA | |
IND_DELHIVERY | |
DE_DPD_DELISTRACK | |
RPD2MAN | |
CN_SF_EXPRESS | |
YANWEN | |
MYS_SKYNET | |
CORREOS_DE_MEXICO | |
CBL_LOGISTICA | |
MEX_ESTAFETA | |
AU_AUSTRIAN_POST | |
RINCOS | |
NLD_DHL | |
RUSSIAN_POST | |
COURIERS_PLEASE | |
POSTNORD_LOGISTICS | |
FEDEX | |
DPE_EXPRESS | |
DPD | DPD. |
ADSONE | |
IDN_JNE | |
THECOURIERGUY | |
CNEXPS | |
PRT_CHRONOPOST | |
LANDMARK_GLOBAL | |
IT_DHL_ECOMMERCE | |
ESP_NACEX | |
PRT_CTT | |
BE_KIALA | |
ASENDIA_UK | |
GLOBAL_TNT | |
POSTUR_IS | |
EPARCEL_KR | |
INPOST_PACZKOMATY | |
IT_POSTE_ITALIA | |
BE_BPOST | |
PL_POCZTA_POLSKA | |
MYS_MYS_POST | |
SG_SG_POST | |
THA_THAILAND_POST | |
LEXSHIP | |
FASTWAY_NZ | |
DHL_AU | |
COSTMETICSNOW | |
PFLOGISTICS | PFL. |
LOOMIS_EXPRESS | |
GLS_ITALY | |
LINE | |
GEL_EXPRESS | |
HUODULL | |
NINJAVAN_SG | |
JANIO | |
AO_COURIER | |
BRT_IT_SENDER_REF | |
SAILPOST | |
LALAMOVE | |
NEWZEALAND_COURIERS | |
ETOMARS | |
VIRTRANSPORT | |
WIZMO | |
PALLETWAYS | |
I_DIKA | |
CFL_LOGISTICS | |
GEMWORLDWIDE | |
GLOBAL_EXPRESS | |
LOGISTYX_TRANSGROUP | |
WESTBANK_COURIER | |
ARCO_SPEDIZIONI | |
YDH_EXPRESS | |
PARCELINKLOGISTICS | |
CNDEXPRESS | |
NOX_NIGHT_TIME_EXPRESS | |
AERONET | |
LTIANEXP | |
INTEGRA2_FTP | |
PARCELONE | |
NOX_NACHTEXPRESS | |
CN_CHINA_POST_EMS | |
CHUKOU1 | |
GLS_SLOV | |
ORANGE_DS | |
JOOM_LOGIS | |
AUS_STARTRACK | |
DHL | |
GB_APC | |
BONDSCOURIERS | |
JPN_JAPAN_POST | |
USPS | |
WINIT | |
ARG_OCA | |
TW_TAIWAN_POST | |
DMM_NETWORK | |
TNT | |
BH_POSTA | |
SWE_POSTNORD | |
CA_CANADA_POST | |
WISELOADS | |
ASENDIA_HK | |
NLD_GLS | |
MEX_REDPACK | |
JET_SHIP | |
DE_DHL_EXPRESS | |
NINJAVAN_THAI | |
RABEN_GROUP | |
ESP_ASM | |
HRV_HRVATSKA | |
GLOBAL_ESTES | |
LTU_LIETUVOS | |
BEL_DHL | |
AU_AU_POST | |
SPEEDEXCOURIER | |
FR_COLIS | |
ARAMEX | |
DPEX | |
MYS_AIRPAK | |
CUCKOOEXPRESS | |
DPD_POLAND | |
NLD_POSTNL | |
NIM_EXPRESS | |
QUANTIUM | |
SENDLE | |
ESP_REDUR | |
MATKAHUOLTO | |
CPACKET | |
POSTI | |
HUNTER_EXPRESS | |
CHOIR_EXP | |
LEGION_EXPRESS | |
AUSTRIAN_POST_EXPRESS | |
GRUPO | |
POSTA_RO | |
INTERPARCEL_UK | |
GLOBAL_ABF | |
POSTEN_NORGE | |
XPERT_DELIVERY | |
DHL_REFR | |
DHL_HK | |
SKYNET_UAE | |
GOJEK | |
YODEL_INTNL | |
JANCO | |
YTO | |
WISE_EXPRESS | |
JTEXPRESS_VN | |
FEDEX_INTL_MLSERV | |
VAMOX | |
AMS_GRP | |
DHL_JP | |
HRPARCEL | |
GESWL | |
BLUESTAR | |
CDEK_TR | |
DESCARTES | |
DELTEC_UK | |
DTDC_EXPRESS | |
TOURLINE | |
BH_WORLDWIDE | |
OCS | |
YINGNUO_LOGISTICS | |
UPS | |
TOLL | |
PRT_SEUR | |
DTDC_AU | |
THA_DYNAMIC_LOGISTICS | |
UBI_LOGISTICS | |
FEDEX_CROSSBORDER | |
A1POST | |
TAZMANIAN_FREIGHT | |
CJ_INT_MY | |
SAIA_FREIGHT | |
SG_QXPRESS | |
NHANS_SOLUTIONS | |
DPD_FR | |
COORDINADORA | |
ANDREANI | |
DOORA | |
INTERPARCEL_NZ | |
PHL_JAMEXPRESS | |
BEL_BELGIUM_POST | |
US_APC | |
IDN_POS | |
FR_MONDIAL | |
DE_DHL | |
HK_RPX | |
DHL_PIECEID | |
VNPOST_EMS | |
RRDONNELLEY | |
DPD_DE | |
DELCART_IN | |
IMEXGLOBALSOLUTIONS | |
ACOMMERCE | |
EURODIS | |
CANPAR | |
GLS | GLS. |
IND_ECOM | |
ESP_ENVIALIA | |
DHL_UK | |
SMSA_EXPRESS | |
TNT_FR | |
DEX_I | |
BUDBEE_WEBHOOK | |
COPA_COURIER | |
VNM_VIETNAM_POST | |
DPD_HK | |
TOLL_NZ | |
ECHO | |
FEDEX_FR | |
BORDEREXPRESS | |
MAILPLUS_JPN | |
TNT_UK_REFR | |
KEC | |
DPD_RO | |
TNT_JP | |
TH_CJ | |
EC_CN | EC_CN. |
FASTWAY_UK | FASTWAY_UK. |
FASTWAY_US | FASTWAY_US. |
GLS_DE | GLS_DE. |
GLS_ES | GLS_ES. |
GLS_FR | GLS_FR. |
MONDIAL_BE | MONDIAL_BE. |
SGT_IT | SGT_IT. |
TNT_CN | TNT_CN. |
TNT_DE | TNT_DE. |
TNT_ES | TNT_ES. |
TNT_PL | TNT_PL. |
PARCELFORCE | PARCELFORCE. |
SWISS_POST | SWISS POST. |
TOLL_IPEC | TOLL IPEC. |
AIR_21 | AIR 21. |
AIRSPEED | AIRSPEED. |
BERT | BERT. |
BLUEDART | BLUEDART. |
COLLECTPLUS | COLLECTPLUS. |
COURIERPLUS | COURIERPLUS. |
COURIER_POST | COURIER POST. |
DHL_GLOBAL_MAIL | dhl_global_mail. |
DPD_UK | dpd_uk. |
DELTEC_DE | DELTEC DE. |
DEUTSCHE_DE | deutsche_de. |
DOTZOT | DOTZOT. |
ELTA_GR | elta_gr. |
EMS_CN | ems_cn. |
ECARGO | ECARGO. |
ENSENDA | ENSENDA. |
FERCAM_IT | fercam_it. |
FASTWAY_ZA | fastway_za. |
FASTWAY_AU | fastway_au. |
FIRST_LOGISITCS | first_logisitcs. |
GEODIS | GEODIS. |
GLOBEGISTICS | GLOBEGISTICS. |
GREYHOUND | GREYHOUND. |
JETSHIP_MY | jetship_my. |
LION_PARCEL | LION PARCEL. |
AEROFLASH | AEROFLASH. |
ONTRAC | ONTRAC. |
SAGAWA | SAGAWA. |
SIODEMKA | SIODEMKA. |
STARTRACK | startrack. |
TNT_AU | tnt_au. |
TNT_IT | tnt_it. |
TRANSMISSION | TRANSMISSION. |
YAMATO | YAMATO. |
DHL_IT | dhl_it. |
DHL_AT | dhl_at. |
LOGISTICSWORLDWIDE_KR | LOGISTICSWORLDWIDE KR. |
GLS_SPAIN | gls_spain. |
AMAZON_UK_API | amazon_uk_api. |
DPD_FR_REFERENCE | dpd_fr_reference. |
DHLPARCEL_UK | dhlparcel_uk. |
MEGASAVE | megasave. |
QUALITYPOST | qualitypost. |
IDS_LOGISTICS | ids_logistics. |
JOYINGBOX | joyingbox. |
PANTHER_ORDER_NUMBER | panther_order_number. |
WATKINS_SHEPARD | watkins_shepard. |
FASTTRACK | fasttrack. |
UP_EXPRESS | up_express. |
ELOGISTICA | elogistica. |
ECOURIER | ecourier. |
CJ_PHILIPPINES | cj_philippines. |
SPEEDEX | speedex. |
ORANGECONNEX | orangeconnex. |
TECOR | tecor. |
SAEE | saee. |
GLS_ITALY_FTP | gls_italy_ftp. |
DELIVERE | delivere. |
YYCOM | yycom. |
ADICIONAL_PT | |
DKSH | DKSH. |
NIPPON_EXPRESS_FTP | |
GOLS | |
FUJEXP | |
QTRACK | |
OMLOGISTICS_API | |
GDPHARM | |
MISUMI_CN | |
AIR_CANADA | Rivo. |
CITY56_WEBHOOK | |
SAGAWA_API | |
KEDAEX | |
PGEON_API | |
WEWORLDEXPRESS | |
JT_LOGISTICS | |
TRUSK | |
VIAXPRESS | |
DHL_SUPPLYCHAIN_ID | |
ZUELLIGPHARMA_SFTP | |
MEEST | |
TOLL_PRIORITY | |
MOTHERSHIP_API | |
CAPITAL | |
EUROPAKET_API | |
HFD | HFD. |
TOURLINE_REFERENCE | |
GIO_ECOURIER | |
CN_LOGISTICS | |
PANDION | |
BPOST_API | |
PASSPORTSHIPPING | |
PAKAJO | |
DACHSER | |
YUSEN_SFTP | |
SHYPLITE | |
XYY | |
MWD | |
FAXECARGO | |
MAZET | |
FIRST_LOGISTICS_API | |
SPRINT_PACK | |
HERMES_DE_FTP | |
CONCISE | |
KERRY_EXPRESS_TW_API | |
EWE | |
FASTDESPATCH | |
ABCUSTOM_SFTP | |
CHAZKI | |
SHIPPIE | |
GEODIS_API | |
NAQEL_EXPRESS | |
PAPA_WEBHOOK | Papa. |
FORWARDAIR | |
DIALOGO_LOGISTICA_API | |
LALAMOVE_API | |
TOMYDOOR | |
KRONOS_WEBHOOK | |
JTCARGO | |
T_CAT | |
CONCISE_WEBHOOK | |
TELEPORT_WEBHOOK | |
CUSTOMCO_API | |
SPX_TH | |
BOLLORE_LOGISTICS | |
CLICKLINK_SFTP | |
M3LOGISTICS | |
VNPOST_API | |
AXLEHIRE_FTP | |
SHADOWFAX | |
MYHERMES_UK_API | EVRi. |
DAIICHI | |
MENSAJEROSURBANOS_API | |
POLARSPEED | |
IDEXPRESS_ID | |
PAYO | Payo. |
WHISTL_SFTP | |
INTEX_DE | |
TRANS2U | |
PRODUCTCAREGROUP_SFTP | |
BIGSMART | |
EXPEDITORS_API_REF | |
AITWORLDWIDE_API | AIT. |
WORLDCOURIER | |
QUIQUP | |
AGEDISS_SFTP | |
ANDREANI_API | |
CRLEXPRESS | |
SMARTCAT | |
CROSSFLIGHT | |
PROCARRIER | |
DHL_REFERENCE_API | |
SEINO_API | |
WSPEXPRESS | |
KRONOS | |
TOTAL_EXPRESS_API | |
PARCLL | |
XPEDIGO | |
STAR_TRACK_WEBHOOK | |
GPOST | |
UCS | UCS. |
DMFGROUP | DMF. |
COORDINADORA_API | |
MARKEN | |
NTL | |
REDJEPAKKETJE | |
ALLIED_EXPRESS_FTP | |
MONDIALRELAY_ES | |
NAEKO_FTP | |
MHI | Mhi. |
SHIPPIFY | |
MALCA_AMIT_API | |
JTEXPRESS_SG_API | |
DACHSER_WEB | |
FLIGHTLG | |
CAGO | Cago. |
COM1EXPRESS | |
TONAMI_FTP | |
PACKFLEET | |
PUROLATOR_INTERNATIONAL | |
WINESHIPPING_WEBHOOK | |
DHL_ES_SFTP | |
PCHOME_API | |
CESKAPOSTA_API | |
GORUSH | |
HOMERUNNER | |
AMAZON_ORDER | |
EFWNOW_API | |
CBL_LOGISTICA_API | |
NIMBUSPOST | |
LOGWIN_LOGISTICS | |
NOWLOG_API | |
DPD_NL | |
GODEPENDABLE | |
ESDEX | |
LOGISYSTEMS_SFTP | |
EXPEDITORS | |
SNTGLOBAL_API | |
SHIPX | |
QINTL_API | |
PACKS | |
POSTNL_INTERNATIONAL | |
AMAZON_EMAIL_PUSH | |
DHL_API | DHL. |
SPX | |
AXLEHIRE | |
ICSCOURIER | |
DIALOGO_LOGISTICA | |
SHUNBANG_EXPRESS | |
TCS_API | TCS. |
SF_EXPRESS_CN | |
PACKETA | |
SIC_TELIWAY | |
MONDIALRELAY_FR | |
INTIME_FTP | |
JD_EXPRESS | 京东物流. |
FASTBOX | |
PATHEON | |
INDIA_POST | |
TIPSA_REF | |
ECOFREIGHT | |
VOX | |
DIRECTFREIGHT_AU_REF | |
BESTTRANSPORT_SFTP | |
AUSTRALIA_POST_API | |
FRAGILEPAK_SFTP | |
FLIPXP | |
VALUE_WEBHOOK | |
DAESHIN | |
SHERPA | |
MWD_API | |
SMARTKARGO | |
DNJ_EXPRESS | |
GOPEOPLE | |
MYSENDLE_API | |
ARAMEX_API | |
PIDGE | |
THAIPARCELS | |
PANTHER_REFERENCE_API | |
POSTAPLUS | |
BUFFALO | |
U_ENVIOS | |
ELITE_CO | |
BARQEXP | Barq. |
ROCHE_INTERNAL_SFTP | |
DBSCHENKER_ICELAND | |
TNT_FR_REFERENCE | |
NEWGISTICSAPI | |
GLOVO | |
GWLOGIS_API | |
SPREETAIL_API | |
MOOVA | |
PLYCONGROUP | |
USPS_WEBHOOK | |
REIMAGINEDELIVERY | |
EDF_FTP | |
DAO365 | |
BIOCAIR_FTP | |
RANSA_WEBHOOK | |
SHIPXPRES | |
COURANT_PLUS_API | |
SHIPA | |
HOMELOGISTICS | |
DX | DX. |
POSTE_ITALIANE_PACCOCELERE | |
TOLL_WEBHOOK | |
LCTBR_API | |
DX_FREIGHT | |
DHL_SFTP | |
SHIPROCKET | |
UBER_WEBHOOK | Uber. |
STATOVERNIGHT | |
BURD | |
FASTSHIP | |
IBVENTURE_WEBHOOK | |
GATI_KWE_API | |
CRYOPDP_FTP | |
HUBBED | |
TIPSA_API | |
ARASKARGO | |
THIJS_NL | |
ATSHEALTHCARE_REFERENCE | |
99MINUTOS | |
HELLENIC_POST | |
HSM_GLOBAL | |
MNX | MNX. |
NMTRANSFER | |
LOGYSTO | |
INDIA_POST_INT | |
AMAZON_FBA_SWISHIP_IN | |
SRT_TRANSPORT | |
BOMI | |
DELIVERR_SFTP | |
HSDEXPRESS | |
SIMPLETIRE_WEBHOOK | |
HUNTER_EXPRESS_SFTP | |
UPS_API | UPS. |
WOOYOUNG_LOGISTICS_SFTP | |
PHSE_API | PHSE. |
WISH_EMAIL_PUSH | Wish. |
NORTHLINE | |
MEDAFRICA | |
DPD_AT_SFTP | |
ANTERAJA | |
DHL_GLOBAL_FORWARDING_API | |
LBCEXPRESS_API | |
SIMSGLOBAL | |
CDLDELIVERS | |
TYP | TYP. |
TESTING_COURIER_WEBHOOK | |
PANDAGO_API | |
ROYAL_MAIL_FTP | |
THUNDEREXPRESS | |
SECRETLAB_WEBHOOK | |
SETEL | |
JD_WORLDWIDE | |
DPD_RU_API | |
ARGENTS_WEBHOOK | |
POSTONE | |
TUSKLOGISTICS | |
RHENUS_UK_API | |
TAQBIN_SG_API | |
INNTRALOG_SFTP | |
DAYROSS | |
CORREOSEXPRESS_API | |
INTERNATIONAL_SEUR_API | |
YODEL_API | |
HEROEXPRESS | |
DHL_SUPPLYCHAIN_IN | |
URGENT_CARGUS | |
FRONTDOORCORP | |
JTEXPRESS_PH | |
PARCELSTARS_WEBHOOK | |
DPD_SK_SFTP | |
MOVIANTO | |
OZEPARTS_SHIPPING | |
KARGOMKOLAY | |
TRUNKRS | |
OMNIRPS_WEBHOOK | |
CHILEXPRESS | |
TESTING_COURIER | |
JNE_API | |
BJSHOMEDELIVERY_FTP | |
DEXPRESS_WEBHOOK | |
USPS_API | |
TRANSVIRTUAL | |
SOLISTICA_API | |
CHIENVENTURE_WEBHOOK | |
DPD_UK_SFTP | |
INPOST_UK | |
JAVIT | |
ZTO_DOMESTIC | |
DHL_GT_API | |
CEVA_TRACKING | |
KOMON_EXPRESS | |
EASTWESTCOURIER_FTP | |
DANNIAO | |
SPECTRAN | |
DELIVER_IT | |
RELAISCOLIS | |
GLS_SPAIN_API | |
POSTPLUS | |
AIRTERRA | |
GIO_ECOURIER_API | |
DPD_CH_SFTP | |
FEDEX_API | |
INTERSMARTTRANS | |
HERMES_UK_SFTP | |
EXELOT_FTP | |
DHL_PA_API | |
VIRTRANSPORT_SFTP | |
WORLDNET | |
INSTABOX_WEBHOOK | |
KNG | |
FLASHEXPRESS_WEBHOOK | |
MAGYAR_POSTA_API | |
WESHIP_API | |
OHI_WEBHOOK | Ohi. |
MUDITA | |
BLUEDART_API | |
T_CAT_API | |
ADS | |
HERMES_IT | |
FITZMARK_API | |
POSTI_API | |
SMSA_EXPRESS_WEBHOOK | |
TAMERGROUP_WEBHOOK | |
LIVRAPIDE | |
NIPPON_EXPRESS | |
BETTERTRUCKS | |
FAN | |
PB_USPSFLATS_FTP | |
PARCELRIGHT | |
ITHINKLOGISTICS | |
KERRY_EXPRESS_TH_WEBHOOK | |
ECOUTIER | |
SHOWL | |
BRT_IT_API | |
RIXONHK_API | |
DBSCHENKER_API | |
ILYANGLOGIS | |
MAIL_BOX_ETC | |
WESHIP | |
DHL_GLOBAL_MAIL_API | |
ACTIVOS24_API | |
ATSHEALTHCARE | |
LUWJISTIK | |
GW_WORLD | |
FAIRSENDEN_API | |
SERVIP_WEBHOOK | |
SWISHIP | |
TANET | |
HOTSIN_CARGO | |
DIREX | |
HUANTONG | |
IMILE_API | |
BDMNET | |
AUEXPRESS | |
NYTLOGISTICS | |
DSV_REFERENCE | |
NOVOFARMA_WEBHOOK | |
AITWORLDWIDE_SFTP | AIT. |
SHOPOLIVE | |
FNF_ZA | |
DHL_ECOMMERCE_GC | |
FETCHR | |
STARLINKS_API | |
YYEXPRESS | |
SERVIENTREGA | |
HANJIN | |
SPANISH_SEUR_FTP | |
DX_B2B_CONNUM | |
HELTHJEM_API | |
INEXPOST | |
A2B_BA | |
RHENUS_GROUP | |
SBERLOGISTICS_RU | |
MALCA_AMIT | |
PPL | |
OSM_WORLDWIDE_SFTP | |
ACILOGISTIX | |
OPTIMACOURIER | |
NOVA_POSHTA_API | |
LOGGI | |
YIFAN | |
MYDYNALOGIC | |
MORNINGLOBAL | |
CONCISE_API | |
FXTRAN | |
DELIVERYOURPARCEL_ZA | |
UPARCEL | |
MOBI_BR | |
LOGINEXT_WEBHOOK | |
EMS | EMS. |
SPEEDY | |
ZOOM_RED | Zoom. |
NAVLUNGO | |
CASTLEPARCELS | |
WEEE | Weee. |
PACKALY | |
YUNHUIPOST | |
YOUPARCEL | |
LEMAN | |
MOOVIN | |
URB_IT | |
MULTIENTREGAPANAMA | |
JUSDASR | |
DISCOUNTPOST | |
RHENUS_UK | |
SWISHIP_JP | |
GLS_US | |
SMTL | |
EMEGA | |
EXPRESSONE_SV | |
HEPSIJET | |
WELIVERY | |
BRINGER | |
EASYROUTES | |
MRW | MRW. |
RPM | RPM. |
DPD_PRT | |
GLS_ROMANIA | |
LMPARCEL | |
GTAGSM | |
DOMINO | |
ESHIPPER | |
TRANSPAK | |
XINDUS | |
AOYUE | |
EASYPARCEL | |
EXPRESSONE | |
SENDEO_KARGO | |
SPEEDAF | |
ETOWER | |
GCX | |
NINJAVAN_VN | |
ALLEGRO | |
JUMPPOINT | |
SHIPGLOBAL_US | |
KINISI | |
OAKH | |
AWEST | |
BARSAN | |
ENERGOLOGISTIC | |
MADROOEX | |
GOBOLT | |
SWISS_UNIVERSAL_EXPRESS | |
IORDIRECT | |
XMSZM | |
GLS_HUN | |
SENDY | |
BRAUNSEXPRESS | |
GRANDSLAMEXPRESS | |
XGS | XGS. |
OTSCHILE | OTS. |
PACK_UP | |
PARCELSTARS | |
TEAMEXPRESSLLC | |
ASYADEXPRESS | |
TDN | TDN. |
EARLYBIRD | |
CACESA | |
PARCELJET | |
MNG_KARGO | |
SUPERPACKLINE | |
SPEEDX | |
VESYL | |
SKYKING | |
DIRMENSAJERIA | DIR. |
NETLOGIXGROUP | |
ZYOU | ZYEX. |
JAWAR | |
AGSYSTEMS | |
GPS | GPS. |
PTT_KARGO | |
MAERGO | |
ARIHANTCOURIER | AICS. |
VTFE | |
YUNANT | |
URBIFY | |
PACK_MAN | |
LIEFERGRUN | |
OBIBOX | |
PAIKEDA | |
SCOTTY | |
INTELCOM_CA | |
SWE | swe. |
ASENDIA | |
DPD_AT | |
RELAY | |
ATA | ATA. |
SKYEXPRESS_INTERNATIONAL | |
SURAT_KARGO | |
SGLINK | |
FLEETOPTICSINC | |
SHOPLINE | |
PIGGYSHIP | |
LOGOIX | |
KOLAY_GELSIN | |
ASSOCIATED_COURIERS | |
UPS_CHECKER | |
WINESHIPPING | |
SPEDISCI |
"DPD_RU"
The intent to either capture payment immediately or authorize a payment for an order after order creation.
The intent to either capture payment immediately or authorize a payment for an order after order creation.
Enum: | Description |
---|---|
CAPTURE | The merchant intends to capture payment immediately after the customer makes a payment. |
AUTHORIZE | The merchant intends to authorize a payment and place funds on hold after the customer makes a payment. Authorized payments are best captured within three days of authorization but are available to capture for up to 29 days. After the three-day honor period, the original authorized payment expires and you must re-authorize the payment. You must make a separate request to capture payments on demand. This intent is not supported when you have more than one |
"CAPTURE"
Details about the merchant cobranded card used for order purchase.
labels | Array of strings [ 1 .. 25 ] items Array of labels for the cobranded card. |
object (payee_base) Merchant associated with the purchase. | |
object (Money) Amount that was charged to the cobranded card. |
{- "labels": [
- "string"
], - "payee": {
- "email_address": "string",
- "merchant_id": "stringstrings"
}, - "amount": {
- "currency_code": "str",
- "value": "string"
}
}
Payer confirms the intent to pay for the Order using the provided payment source.
object (Order Confirm Application Context) Customizes the payer confirmation experience. | |
required | object (payment_source) The payment source definition. |
{- "application_context": {
- "brand_name": "string",
- "locale": "string",
- "stored_payment_source": {
- "payment_initiator": "CUSTOMER",
- "payment_type": "ONE_TIME",
- "usage": "FIRST",
- "previous_network_transaction_reference": {
- "id": "stringstr",
- "date": "stri",
- "acquirer_reference_number": "string",
- "network": "VISA"
}
}
}, - "payment_source": {
- "card": {
- "name": "string",
- "number": "stringstrings",
- "security_code": "stri",
- "expiry": "string",
- "billing_address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}, - "attributes": {
- "customer": {
- "id": "string",
- "email_address": "string",
- "phone": {
- "phone_type": "FAX",
- "phone_number": {
- "national_number": "string"
}
}, - "merchant_customer_id": "string"
}, - "vault": {
- "store_in_vault": "ON_SUCCESS"
}, - "verification": {
- "method": "SCA_ALWAYS"
}
}, - "stored_credential": {
- "payment_initiator": "CUSTOMER",
- "payment_type": "ONE_TIME",
- "usage": "FIRST",
- "previous_network_transaction_reference": {
- "id": "stringstr",
- "date": "stri",
- "acquirer_reference_number": "string",
- "network": "VISA"
}
}, - "vault_id": "string",
- "single_use_token": "string",
- "network_token": {
- "number": "stringstrings",
- "cryptogram": "stringstringstringstringstri",
- "token_requestor_id": "string",
- "expiry": "string",
- "eci_flag": "MASTERCARD_NON_3D_SECURE_TRANSACTION"
}, - "experience_context": {
- "return_url": "string",
- "cancel_url": "string"
}
}, - "token": {
- "id": "string",
- "type": "BILLING_AGREEMENT"
}, - "paypal": {
- "experience_context": {
- "brand_name": "string",
- "shipping_preference": "GET_FROM_FILE",
- "landing_page": "LOGIN",
- "user_action": "CONTINUE",
- "payment_method_preference": "UNRESTRICTED",
- "locale": "string",
- "return_url": "string",
- "cancel_url": "string"
}, - "billing_agreement_id": "string",
- "vault_id": "string",
- "email_address": "string",
- "name": {
- "given_name": "string",
- "surname": "string"
}, - "phone": {
- "phone_type": "FAX",
- "phone_number": {
- "national_number": "string"
}
}, - "birth_date": "stringstri",
- "tax_info": {
- "tax_id": "string",
- "tax_id_type": "BR_CPF"
}, - "address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}, - "attributes": {
- "customer": {
- "id": "string",
- "email_address": "string",
- "merchant_customer_id": "string"
}, - "vault": {
- "store_in_vault": "ON_SUCCESS",
- "description": "string",
- "usage_pattern": "string",
- "usage_type": "string",
- "customer_type": "CONSUMER",
- "permit_multiple_payment_tokens": false
}
}
}, - "bancontact": {
- "name": "string",
- "country_code": "string",
- "experience_context": {
- "brand_name": "string",
- "shipping_preference": "GET_FROM_FILE",
- "locale": "string",
- "return_url": "string",
- "cancel_url": "string"
}
}, - "blik": {
- "name": "string",
- "country_code": "string",
- "email": "string",
- "experience_context": {
- "brand_name": "string",
- "shipping_preference": "GET_FROM_FILE",
- "locale": "string",
- "return_url": "string",
- "cancel_url": "string",
- "consumer_user_agent": "string",
- "consumer_ip": "string"
}, - "level_0": {
- "auth_code": "string"
}, - "one_click": {
- "auth_code": "string",
- "consumer_reference": "string",
- "alias_label": "stringst",
- "alias_key": "string"
}
}, - "eps": {
- "name": "string",
- "country_code": "string",
- "experience_context": {
- "brand_name": "string",
- "shipping_preference": "GET_FROM_FILE",
- "locale": "string",
- "return_url": "string",
- "cancel_url": "string"
}
}, - "giropay": {
- "name": "string",
- "country_code": "string",
- "experience_context": {
- "brand_name": "string",
- "shipping_preference": "GET_FROM_FILE",
- "locale": "string",
- "return_url": "string",
- "cancel_url": "string"
}
}, - "ideal": {
- "name": "string",
- "country_code": "string",
- "bic": "string",
- "experience_context": {
- "brand_name": "string",
- "shipping_preference": "GET_FROM_FILE",
- "locale": "string",
- "return_url": "string",
- "cancel_url": "string"
}
}, - "mybank": {
- "name": "string",
- "country_code": "string",
- "experience_context": {
- "brand_name": "string",
- "shipping_preference": "GET_FROM_FILE",
- "locale": "string",
- "return_url": "string",
- "cancel_url": "string"
}
}, - "p24": {
- "name": "string",
- "email": "string",
- "country_code": "string",
- "experience_context": {
- "brand_name": "string",
- "shipping_preference": "GET_FROM_FILE",
- "locale": "string",
- "return_url": "string",
- "cancel_url": "string"
}
}, - "sofort": {
- "name": "string",
- "country_code": "string",
- "experience_context": {
- "brand_name": "string",
- "shipping_preference": "GET_FROM_FILE",
- "locale": "string",
- "return_url": "string",
- "cancel_url": "string"
}
}, - "trustly": {
- "name": "string",
- "country_code": "string",
- "experience_context": {
- "brand_name": "string",
- "shipping_preference": "GET_FROM_FILE",
- "locale": "string",
- "return_url": "string",
- "cancel_url": "string"
}
}, - "apple_pay": {
- "id": "string",
- "stored_credential": {
- "payment_initiator": "CUSTOMER",
- "payment_type": "ONE_TIME",
- "usage": "FIRST",
- "previous_network_transaction_reference": {
- "id": "stringstr",
- "date": "stri",
- "acquirer_reference_number": "string",
- "network": "VISA"
}
}, - "attributes": {
- "customer": {
- "id": "string",
- "email_address": "string",
- "phone": {
- "phone_type": "FAX",
- "phone_number": {
- "national_number": "string"
}
}
}, - "vault": {
- "store_in_vault": "ON_SUCCESS"
}
}, - "name": "string",
- "email_address": "string",
- "phone_number": {
- "national_number": "string"
}, - "decrypted_token": {
- "device_manufacturer_id": "string",
- "payment_data_type": "3DSECURE",
- "transaction_amount": {
- "currency_code": "str",
- "value": "string"
}, - "tokenized_card": {
- "name": "string",
- "number": "stringstrings",
- "expiry": "string",
- "card_type": "VISA",
- "type": "CREDIT",
- "brand": "VISA",
- "billing_address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
}, - "payment_data": {
- "cryptogram": "string",
- "eci_indicator": "string",
- "emv_data": "string",
- "pin": "string"
}
}, - "vault_id": "string"
}, - "google_pay": {
- "name": "string",
- "email_address": "string",
- "phone_number": {
- "country_code": "str",
- "national_number": "string"
}, - "card": {
- "name": "string",
- "type": "CREDIT",
- "brand": "VISA",
- "billing_address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
}, - "decrypted_token": {
- "message_id": "string",
- "message_expiration": "stringstrings",
- "payment_method": "CARD",
- "authentication_method": "PAN_ONLY",
- "cryptogram": "string",
- "eci_indicator": "string",
- "card": {
- "name": "string",
- "number": "stringstrings",
- "last_digits": "stri",
- "expiry": "string",
- "type": "CREDIT",
- "brand": "VISA",
- "billing_address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
}
}, - "assurance_details": {
- "account_verified": false,
- "card_holder_authenticated": false
}, - "attributes": {
- "verification": {
- "method": "SCA_ALWAYS"
}
}
}, - "venmo": {
- "experience_context": {
- "brand_name": "string",
- "shipping_preference": "GET_FROM_FILE"
}, - "vault_id": "string",
- "email_address": "string",
- "attributes": {
- "customer": {
- "id": "string",
- "email_address": "string"
}, - "vault": {
- "store_in_vault": "ON_SUCCESS",
- "description": "string",
- "usage_pattern": "string",
- "usage_type": "string",
- "customer_type": "CONSUMER",
- "permit_multiple_payment_tokens": false
}
}
}
}
}
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 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 three-character ISO-4217 currency code that identifies the currency.
The three-character ISO-4217 currency code that identifies the currency.
"str"
The details about a customer in PayPal's system of record.
id | string (merchant_partner_customer_id) [ 1 .. 22 ] characters ^[0-9a-zA-Z_-]+$ The unique ID for a customer generated by PayPal. |
{- "id": "string"
}
The details about a customer in PayPal's system of record.
id | string (merchant_partner_customer_id) [ 1 .. 22 ] characters ^[0-9a-zA-Z_-]+$ The unique ID for a customer generated by PayPal. |
email_address | string <merchant_common_email_address_v2> (email) [ 3 .. 254 ] characters (?:[a-zA-Z0-9!#$%&'*+/=?^_`{|}~-]+(?:\.[a-zA-... Email address of the buyer as provided to the merchant or on file with the merchant. Email Address is required if you are processing the transaction using PayPal Guest Processing which is offered to select partners and merchants. For all other use cases we do not expect partners/merchant to send email_address of their customer. |
object (phone_with_type) The phone number of the buyer as provided to the merchant or on file with the merchant. The |
{- "id": "string",
- "email_address": "string",
- "phone": {
- "phone_type": "FAX",
- "phone_number": {
- "national_number": "string"
}
}
}
The details about a customer in PayPal's system of record.
id | string (merchant_partner_customer_id) [ 1 .. 22 ] characters ^[0-9a-zA-Z_-]+$ The unique ID for a customer generated by PayPal. |
email_address | string <merchant_common_email_address_v2> (email) [ 3 .. 254 ] characters (?:[a-zA-Z0-9!#$%&'*+/=?^_`{|}~-]+(?:\.[a-zA-... Email address of the buyer as provided to the merchant or on file with the merchant. Email Address is required if you are processing the transaction using PayPal Guest Processing which is offered to select partners and merchants. For all other use cases we do not expect partners/merchant to send email_address of their customer. |
{- "id": "string",
- "email_address": "string"
}
The stand-alone date, in Internet date and time format. 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.
The stand-alone date, in Internet date and time format. 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.
"stringstri"
The stand-alone date, in Internet date and time format. 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.
The stand-alone date, in Internet date and time format. 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.
"stringstri"
The stand-alone date, in Internet date and time format. 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.
The stand-alone date, in Internet date and time format. 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.
"stringstri"
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 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 year and month, in ISO-8601 YYYY-MM
date format. See Internet date and time format.
The year and month, in ISO-8601 YYYY-MM
date format. See Internet date and time format.
"strings"
The year and month, in ISO-8601 YYYY-MM
date format. See Internet date and time format.
The year and month, in ISO-8601 YYYY-MM
date format. See Internet date and time format.
"strings"
The funds that are held on behalf of the merchant.
The funds that are held on behalf of the merchant.
Enum: | Description |
---|---|
INSTANT | The funds are released to the merchant immediately. |
DELAYED | The funds are held for a finite number of days. The actual duration depends on the region and type of integration. You can release the funds through a referenced payout. Otherwise, the funds disbursed automatically after the specified duration. |
"INSTANT"
Electronic Commerce Indicator (ECI). The ECI value is part of the 2 data elements that indicate the transaction was processed electronically. This should be passed on the authorization transaction to the Gateway/Processor.
Electronic Commerce Indicator (ECI). The ECI value is part of the 2 data elements that indicate the transaction was processed electronically. This should be passed on the authorization transaction to the Gateway/Processor.
Enum: | Description |
---|---|
MASTERCARD_NON_3D_SECURE_TRANSACTION | Mastercard non-3-D Secure transaction. |
MASTERCARD_ATTEMPTED_AUTHENTICATION_TRANSACTION | Mastercard attempted authentication transaction. |
MASTERCARD_FULLY_AUTHENTICATED_TRANSACTION | Mastercard fully authenticated transaction. |
FULLY_AUTHENTICATED_TRANSACTION | VISA, AMEX, JCB, DINERS CLUB fully authenticated transaction. |
ATTEMPTED_AUTHENTICATION_TRANSACTION | VISA, AMEX, JCB, DINERS CLUB attempted authentication transaction. |
NON_3D_SECURE_TRANSACTION | VISA, AMEX, JCB, DINERS CLUB non-3-D Secure transaction. |
"MASTERCARD_NON_3D_SECURE_TRANSACTION"
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 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 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"
Status of Authentication eligibility.
Status of Authentication eligibility.
Enum: | Description |
---|---|
Y | Yes. The bank is participating in 3-D Secure protocol and will return the ACSUrl. |
N | No. The bank is not participating in 3-D Secure protocol. |
U | Unavailable. The DS or ACS is not available for authentication at the time of the request. |
B | Bypass. The merchant authentication rule is triggered to bypass authentication. |
"Y"
Information used to pay using eps.
name | string (name) [ 3 .. 300 ] characters The name of the account holder associated with this payment method. |
country_code | string <ppaas_common_country_code_v2> (country_code) = 2 characters ^([A-Z]{2}|C2)$ The two-character ISO 3166-1 country code. |
bic | string (BIC) [ 8 .. 11 ] characters ^[A-Z-a-z0-9]{4}[A-Z-a-z]{2}[A-Z-a-z0-9]{2}([... The bank identification code (BIC). |
{- "name": "string",
- "country_code": "string",
- "bic": "string"
}
Information needed to pay using eps.
name required | string (name) [ 3 .. 300 ] characters The name of the account holder associated with this payment method. |
country_code required | string <ppaas_common_country_code_v2> (country_code) = 2 characters ^([A-Z]{2}|C2)$ The two-character ISO 3166-1 country code. |
object (experience_context_base) Customizes the payer experience during the approval process for the payment. |
{- "name": "string",
- "country_code": "string",
- "experience_context": {
- "brand_name": "string",
- "shipping_preference": "GET_FROM_FILE",
- "locale": "string",
- "return_url": "string",
- "cancel_url": "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. |
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",
- "details": [
- {
- "field": "string",
- "value": "string",
- "location": "body",
- "issue": "string",
- "links": [
- {
- "href": "string",
- "rel": "string",
- "method": "GET"
}
], - "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. |
Array of objects (Link Description) [ 1 .. 4 ] items An array of request-related HATEOAS links that are either relevant to the issue by providing additional information or offering potential resolutions. | |
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",
- "links": [
- {
- "href": "string",
- "rel": "string",
- "method": "GET"
}
], - "description": "string"
}
The exchange rate that determines the amount to convert from one currency to another currency.
value | string The target currency amount. Equivalent to one unit of the source currency. Formatted as integer or decimal value with one to 15 digits to the right of the decimal point. |
source_currency | string <ppaas_common_currency_code_v2> (currency_code) = 3 characters The source currency from which to convert an amount. |
target_currency | string <ppaas_common_currency_code_v2> (currency_code) = 3 characters The target currency to which to convert an amount. |
{- "value": "string",
- "source_currency": "str",
- "target_currency": "str"
}
Customizes the payer experience during the approval process for the payment.
brand_name | string [ 1 .. 127 ] characters ^.*$ 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. | ||||||||
shipping_preference | string [ 1 .. 24 ] characters ^[A-Z_]+$ Default: "GET_FROM_FILE" The location from which the shipping address is derived.
| ||||||||
locale | string <ppaas_common_language_v3> (language) [ 2 .. 10 ] characters ^[a-z]{2}(?:-[A-Z][a-z]{3})?(?:-(?:[A-Z]{2}|[... The BCP 47-formatted locale of pages that the PayPal payment experience shows. PayPal supports a five-character code. For example, | ||||||||
return_url | string <uri> (url) The URL where the customer is redirected after the customer approves the payment. | ||||||||
cancel_url | string <uri> (url) The URL where the customer is redirected after the customer cancels the payment. |
{- "brand_name": "string",
- "shipping_preference": "GET_FROM_FILE",
- "locale": "string",
- "return_url": "string",
- "cancel_url": "string"
}
Customizes the payer experience during the approval process for the payment.
locale | string <ppaas_common_language_v3> (language) [ 2 .. 10 ] characters ^[a-z]{2}(?:-[A-Z][a-z]{3})?(?:-(?:[A-Z]{2}|[... The BCP 47-formatted locale of pages that the PayPal payment experience shows. PayPal supports a five-character code. For example, |
return_url | string <uri> (url) The URL where the customer is redirected after the customer approves the payment. |
cancel_url | string <uri> (url) The URL where the customer is redirected after the customer cancels the payment. |
{- "locale": "string",
- "return_url": "string",
- "cancel_url": "string"
}
Information needed to pay using giropay.
name | string (name) [ 3 .. 300 ] characters The name of the account holder associated with this payment method. |
country_code | string <ppaas_common_country_code_v2> (country_code) = 2 characters ^([A-Z]{2}|C2)$ The two-character ISO 3166-1 country code. |
bic | string (BIC) [ 8 .. 11 ] characters ^[A-Z-a-z0-9]{4}[A-Z-a-z]{2}[A-Z-a-z0-9]{2}([... The bank identification code (BIC). |
{- "name": "string",
- "country_code": "string",
- "bic": "string"
}
Information needed to pay using giropay.
name required | string (name) [ 3 .. 300 ] characters The name of the account holder associated with this payment method. |
country_code required | string <ppaas_common_country_code_v2> (country_code) = 2 characters ^([A-Z]{2}|C2)$ The two-character ISO 3166-1 country code. |
object (experience_context_base) Customizes the payer experience during the approval process for the payment. |
{- "name": "string",
- "country_code": "string",
- "experience_context": {
- "brand_name": "string",
- "shipping_preference": "GET_FROM_FILE",
- "locale": "string",
- "return_url": "string",
- "cancel_url": "string"
}
}
Google Pay Wallet payment data.
name | string (name) [ 3 .. 300 ] characters Name on the account holder associated with Google Pay. |
email_address | string <ppaas_common_email_address_v2> (email_address) [ 3 .. 254 ] characters ^(?:[A-Za-z0-9!#$%&'*+/=?^_`{|}~-]+(?:\.[A-Za... The email address of the account holder associated with Google Pay. |
object (Phone) The phone number of account holder, in its canonical international E.164 numbering plan format. Supports only the | |
object (google_pay_card_response) The Card from Google Pay Wallet used to fund the payment. |
{- "name": "string",
- "email_address": "string",
- "phone_number": {
- "country_code": "str",
- "national_number": "string"
}, - "card": {
- "name": "string",
- "last_digits": "stri",
- "type": "CREDIT",
- "brand": "VISA",
- "billing_address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}, - "authentication_result": {
- "liability_shift": "NO",
- "three_d_secure": {
- "authentication_status": "Y",
- "enrollment_status": "Y"
}
}
}
}
The payment card used to fund a Google Pay payment. Can be a credit or debit card.
name | string [ 1 .. 300 ] characters ^.{1,300}$ The card holder's name as it appears on the card. | ||||||||||||||||||||||||||||||||||||||||||||||||||||
type | string (card_type) [ 1 .. 255 ] characters ^[A-Z_]+$ The payment card type.
| ||||||||||||||||||||||||||||||||||||||||||||||||||||
brand | string (card_brand) [ 1 .. 255 ] characters ^[A-Z_]+$ The card brand or network. Typically used in the response.
| ||||||||||||||||||||||||||||||||||||||||||||||||||||
object (Portable Postal Address (Medium-Grained)) The billing address for this card. Supports only the |
{- "name": "string",
- "type": "CREDIT",
- "brand": "VISA",
- "billing_address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
}
The payment card used to fund a Google Pay payment. Can be a credit or debit card.
name | string [ 1 .. 300 ] characters ^.{1,300}$ The card holder's name as it appears on the card. | ||||||||||||||||||||||||||||||||||||||||||||||||||||
number required | string [ 13 .. 19 ] characters ^[0-9]{13,19}$ The primary account number (PAN) for the payment card. | ||||||||||||||||||||||||||||||||||||||||||||||||||||
last_digits | string [ 2 .. 4 ] characters ^[0-9]{2,4}$ The last digits of the payment card. | ||||||||||||||||||||||||||||||||||||||||||||||||||||
expiry required | string (date_year_month) = 7 characters ^[0-9]{4}-(0[1-9]|1[0-2])$ The card expiration year and month, in Internet date format. | ||||||||||||||||||||||||||||||||||||||||||||||||||||
type | string (card_type) [ 1 .. 255 ] characters ^[A-Z_]+$ The payment card type.
| ||||||||||||||||||||||||||||||||||||||||||||||||||||
brand | string (card_brand) [ 1 .. 255 ] characters ^[A-Z_]+$ The card brand or network. Typically used in the response.
| ||||||||||||||||||||||||||||||||||||||||||||||||||||
object (Portable Postal Address (Medium-Grained)) The billing address for this card. Supports only the |
{- "name": "string",
- "number": "stringstrings",
- "last_digits": "stri",
- "expiry": "string",
- "type": "CREDIT",
- "brand": "VISA",
- "billing_address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
}
The payment card to use to fund a Google Pay payment response. Can be a credit or debit card.
name | string [ 1 .. 300 ] characters ^.{1,300}$ The card holder's name as it appears on the card. | ||||||||||||||||||||||||||||||||||||||||||||||||||||
last_digits | string [ 2 .. 4 ] characters ^[0-9]{2,4}$ The last digits of the payment card. | ||||||||||||||||||||||||||||||||||||||||||||||||||||
type | string (card_type) [ 1 .. 255 ] characters ^[A-Z_]+$ The payment card type.
| ||||||||||||||||||||||||||||||||||||||||||||||||||||
brand | string (card_brand) [ 1 .. 255 ] characters ^[A-Z_]+$ The card brand or network. Typically used in the response.
| ||||||||||||||||||||||||||||||||||||||||||||||||||||
object (Portable Postal Address (Medium-Grained)) The billing address for this card. Supports only the | |||||||||||||||||||||||||||||||||||||||||||||||||||||
object (authentication_response) Results of Authentication such as 3D Secure. |
{- "name": "string",
- "last_digits": "stri",
- "type": "CREDIT",
- "brand": "VISA",
- "billing_address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}, - "authentication_result": {
- "liability_shift": "NO",
- "three_d_secure": {
- "authentication_status": "Y",
- "enrollment_status": "Y"
}
}
}
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.
message_id | string [ 1 .. 250 ] characters ^.*$ A unique ID that identifies the message in case it needs to be revoked or located at a later time. | ||||||
message_expiration | string = 13 characters \d{13} Date and time at which the message expires as UTC milliseconds since epoch. Integrators should reject any message that's expired. | ||||||
payment_method required | string = 4 characters The type of the payment credential. Currently, only CARD is supported.
| ||||||
authentication_method required | string [ 1 .. 50 ] characters Authentication Method which is used for the card transaction.
| ||||||
cryptogram | string [ 1 .. 2000 ] characters 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. | ||||||
eci_indicator | string [ 1 .. 256 ] characters ^.*$ 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. | ||||||
required | object (google_pay_card) Google Pay tokenized credit card used to pay. |
{- "message_id": "string",
- "message_expiration": "stringstrings",
- "payment_method": "CARD",
- "authentication_method": "PAN_ONLY",
- "cryptogram": "string",
- "eci_indicator": "string",
- "card": {
- "name": "string",
- "number": "stringstrings",
- "last_digits": "stri",
- "expiry": "string",
- "type": "CREDIT",
- "brand": "VISA",
- "billing_address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
}
}
Information needed to pay using Google Pay.
name | string (name) [ 3 .. 300 ] characters Name on the account holder associated with Google Pay. |
email_address | string <ppaas_common_email_address_v2> (email_address) [ 3 .. 254 ] characters ^(?:[A-Za-z0-9!#$%&'*+/=?^_`{|}~-]+(?:\.[A-Za... The email address of the account holder associated with Google Pay. |
object (Phone) The phone number of account holder, in its canonical international E.164 numbering plan format. Supports only the | |
object (google_pay_card) The payment card information. | |
object (google_pay_decrypted_token_data) The decrypted payload details for the Google Pay token. | |
object (assurance_details) Information about what validation has been performed on the returned payment credentials. | |
object (card_attributes) Additional attributes associated with the use of this card. |
{- "name": "string",
- "email_address": "string",
- "phone_number": {
- "country_code": "str",
- "national_number": "string"
}, - "card": {
- "name": "string",
- "type": "CREDIT",
- "brand": "VISA",
- "billing_address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
}, - "decrypted_token": {
- "message_id": "string",
- "message_expiration": "stringstrings",
- "payment_method": "CARD",
- "authentication_method": "PAN_ONLY",
- "cryptogram": "string",
- "eci_indicator": "string",
- "card": {
- "name": "string",
- "number": "stringstrings",
- "last_digits": "stri",
- "expiry": "string",
- "type": "CREDIT",
- "brand": "VISA",
- "billing_address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
}
}, - "assurance_details": {
- "account_verified": false,
- "card_holder_authenticated": false
}, - "attributes": {
- "verification": {
- "method": "SCA_ALWAYS"
}
}
}
The last characters of the IBAN used to pay.
The last characters of the IBAN used to pay.
"string"
Information used to pay using iDEAL.
name | string (name) [ 3 .. 300 ] characters The name of the account holder associated with this payment method. |
country_code | string <ppaas_common_country_code_v2> (country_code) = 2 characters ^([A-Z]{2}|C2)$ The two-character ISO 3166-1 country code. |
bic | string (BIC) [ 8 .. 11 ] characters ^[A-Z-a-z0-9]{4}[A-Z-a-z]{2}[A-Z-a-z0-9]{2}([... The bank identification code (BIC). |
iban_last_chars | string (iban_last_chars) [ 4 .. 34 ] characters [a-zA-Z0-9]{4} The last characters of the IBAN used to pay. |
{- "name": "string",
- "country_code": "string",
- "bic": "string",
- "iban_last_chars": "string"
}
Information needed to pay using iDEAL.
name required | string (name) [ 3 .. 300 ] characters The name of the account holder associated with this payment method. |
country_code required | string <ppaas_common_country_code_v2> (country_code) = 2 characters ^([A-Z]{2}|C2)$ The two-character ISO 3166-1 country code. |
bic | string (BIC) [ 8 .. 11 ] characters ^[A-Z-a-z0-9]{4}[A-Z-a-z]{2}[A-Z-a-z0-9]{2}([... The bank identification code (BIC). |
object (experience_context_base) Customizes the payer experience during the approval process for the payment. |
{- "name": "string",
- "country_code": "string",
- "bic": "string",
- "experience_context": {
- "brand_name": "string",
- "shipping_preference": "GET_FROM_FILE",
- "locale": "string",
- "return_url": "string",
- "cancel_url": "string"
}
}
The identifier of the instrument.
The identifier of the instrument.
"string"
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.
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.
"strings"
The details for the items to be purchased.
name required | string [ 1 .. 127 ] characters The item name or title. | ||||||||
quantity required | string <= 10 characters ^[1-9][0-9]{0,9}$ The item quantity. Must be a whole number. | ||||||||
description | string <= 127 characters The detailed item description. | ||||||||
sku | string <= 127 characters The stock keeping unit (SKU) for the item. | ||||||||
url | string <uri> [ 1 .. 2048 ] characters The URL to the item being purchased. Visible to buyer and used in buyer experiences. | ||||||||
category | string [ 1 .. 20 ] characters The item category type.
| ||||||||
image_url | string <uri> [ 1 .. 2048 ] characters ^(https:)([/|.|\w|\s|-])*\.(?:jpg|gif|png|jpe... The URL of the item's image. File type and size restrictions apply. An image that violates these restrictions will not be honored. | ||||||||
required | object (Money) The item price or rate per unit. If you specify | ||||||||
object (Money) The item tax for each unit. If | |||||||||
object (universal_product_code) The Universal Product Code of the item. |
{- "name": "string",
- "quantity": "string",
- "description": "string",
- "sku": "string",
- "category": "DIGITAL_GOODS",
- "unit_amount": {
- "currency_code": "str",
- "value": "string"
}, - "tax": {
- "currency_code": "str",
- "value": "string"
}, - "upc": {
- "type": "UPC-A",
- "code": "string"
}
}
The details for the items to be purchased.
name required | string [ 1 .. 127 ] characters The item name or title. |
quantity required | string <= 10 characters ^[1-9][0-9]{0,9}$ The item quantity. Must be a whole number. |
description | string <= 127 characters The detailed item description. |
sku | string <= 127 characters The stock keeping unit (SKU) for the item. |
url | string <uri> [ 1 .. 2048 ] characters The URL to the item being purchased. Visible to buyer and used in buyer experiences. |
image_url | string <uri> [ 1 .. 2048 ] characters ^(https:)([/|.|\w|\s|-])*\.(?:jpg|gif|png|jpe... The URL of the item's image. File type and size restrictions apply. An image that violates these restrictions will not be honored. |
object (universal_product_code) The Universal Product Code of the item. |
{- "name": "string",
- "quantity": "string",
- "description": "string",
- "sku": "string",
- "upc": {
- "type": "UPC-A",
- "code": "string"
}
}
The language tag 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, the optional ISO-15924 script tag, and the ISO-3166 alpha-2 country code or M49 region code.
The language tag 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, the optional ISO-15924 script tag, and the ISO-3166 alpha-2 country code or M49 region code.
"string"
The language tag 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, the optional ISO-15924 script tag, and the ISO-3166 alpha-2 country code or M49 region code.
The language tag 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, the optional ISO-15924 script tag, and the ISO-3166 alpha-2 country code or M49 region code.
"string"
The level 2 card processing data collections. If your merchant account has been configured for Level 2 processing this field will be passed to the processor on your behalf. Please contact your PayPal Technical Account Manager to define level 2 data for your business.
invoice_id | string [ 1 .. 127 ] characters ^[\w‘\-.,":;\!?]*$ Use this field to pass a purchase identification value of up to 127 ASCII characters. The length of this field will be adjusted to meet network specifications (25chars for Visa and Mastercard, 17chars for Amex), and the original invoice ID will still be displayed in your existing reports. |
object (Money) Use this field to break down the amount of tax included in the total purchase amount. The value provided here will not add to the total purchase amount. The value can't be negative, and in most cases, it must be greater than zero in order to qualify for lower interchange rates. Value, by country, is:
|
{- "invoice_id": "string",
- "tax_total": {
- "currency_code": "str",
- "value": "string"
}
}
The level 3 card processing data collections, If your merchant account has been configured for Level 3 processing this field will be passed to the processor on your behalf. Please contact your PayPal Technical Account Manager to define level 3 data for your business.
ships_from_postal_code | string [ 1 .. 60 ] characters ^[a-zA-Z0-9_'.-]*$ Use this field to specify the postal code of the shipping location. |
Array of objects (line_item) [ 1 .. 100 ] items A list of the items that were purchased with this payment. If your merchant account has been configured for Level 3 processing this field will be passed to the processor on your behalf. | |
object (Money) Use this field to break down the shipping cost included in the total purchase amount. The value provided here will not add to the total purchase amount. The value cannot be negative. | |
object (Money) Use this field to break down the duty amount included in the total purchase amount. The value provided here will not add to the total purchase amount. The value cannot be negative. | |
object (Money) Use this field to break down the discount amount included in the total purchase amount. The value provided here will not add to the total purchase amount. The value cannot be negative. | |
object (Portable Postal Address (Medium-Grained)) The address of the person to whom to ship the items. Supports only the |
{- "ships_from_postal_code": "string",
- "line_items": [
- {
- "name": "string",
- "quantity": "string",
- "description": "string",
- "sku": "string",
- "upc": {
- "type": "UPC-A",
- "code": "string"
}, - "commodity_code": "string",
- "unit_of_measure": "string",
- "unit_amount": {
- "currency_code": "str",
- "value": "string"
}, - "tax": {
- "currency_code": "str",
- "value": "string"
}, - "discount_amount": {
- "currency_code": "str",
- "value": "string"
}, - "total_amount": {
- "currency_code": "str",
- "value": "string"
}
}
], - "shipping_amount": {
- "currency_code": "str",
- "value": "string"
}, - "duty_amount": {
- "currency_code": "str",
- "value": "string"
}, - "discount_amount": {
- "currency_code": "str",
- "value": "string"
}, - "shipping_address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
}
Liability shift indicator. The outcome of the issuer's authentication.
Liability shift indicator. The outcome of the issuer's authentication.
Enum: | Description |
---|---|
NO | Liability is with the merchant. |
POSSIBLE | Liability may shift to the card issuer. |
UNKNOWN | The authentication system is not available. |
"NO"
The line items for this purchase. If your merchant account has been configured for Level 3 processing this field will be passed to the processor on your behalf.
name required | string [ 1 .. 127 ] characters The item name or title. |
quantity required | string <= 10 characters ^[1-9][0-9]{0,9}$ The item quantity. Must be a whole number. |
description | string <= 127 characters The detailed item description. |
sku | string <= 127 characters The stock keeping unit (SKU) for the item. |
url | string <uri> [ 1 .. 2048 ] characters The URL to the item being purchased. Visible to buyer and used in buyer experiences. |
image_url | string <uri> [ 1 .. 2048 ] characters ^(https:)([/|.|\w|\s|-])*\.(?:jpg|gif|png|jpe... The URL of the item's image. File type and size restrictions apply. An image that violates these restrictions will not be honored. |
object (universal_product_code) The Universal Product Code of the item. | |
commodity_code | string [ 1 .. 12 ] characters ^[a-zA-Z0-9_'.-]*$ Code used to classify items purchased and track the total amount spent across various categories of products and services. Different corporate purchasing organizations may use different standards, but the United Nations Standard Products and Services Code (UNSPSC) is frequently used. |
unit_of_measure | string [ 1 .. 12 ] characters ^[a-zA-Z0-9_'.-]*$ Unit of measure is a standard used to express the magnitude of a quantity in international trade. Most commonly used (but not limited to) examples are: Acre (ACR), Ampere (AMP), Centigram (CGM), Centimetre (CMT), Cubic inch (INQ), Cubic metre (MTQ), Fluid ounce (OZA), Foot (FOT), Hour (HUR), Item (ITM), Kilogram (KGM), Kilometre (KMT), Kilowatt (KWT), Liquid gallon (GLL), Liter (LTR), Pounds (LBS), Square foot (FTK). |
required | object (Money) The item price or rate per unit. Must equal |
object (Money) The item tax for each unit. Must equal | |
object (Money) Use this field to break down the discount amount included in the total purchase amount. The value provided here will not add to the total purchase amount. The value cannot be negative. | |
object (Money) The subtotal for all items. Must equal the sum of (items[].unit_amount * items[].quantity) for all items. item_total.value can not be a negative number. |
{- "name": "string",
- "quantity": "string",
- "description": "string",
- "sku": "string",
- "upc": {
- "type": "UPC-A",
- "code": "string"
}, - "commodity_code": "string",
- "unit_of_measure": "string",
- "unit_amount": {
- "currency_code": "str",
- "value": "string"
}, - "tax": {
- "currency_code": "str",
- "value": "string"
}, - "discount_amount": {
- "currency_code": "str",
- "value": "string"
}, - "total_amount": {
- "currency_code": "str",
- "value": "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"
}
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"
}
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"
}
The unique ID for a customer generated by PayPal.
The unique ID for a customer generated by PayPal.
"string"
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 three-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"
}
Information used to pay using MyBank.
name | string (name) [ 3 .. 300 ] characters The name of the account holder associated with this payment method. |
country_code | string <ppaas_common_country_code_v2> (country_code) = 2 characters ^([A-Z]{2}|C2)$ The two-character ISO 3166-1 country code. |
bic | string (BIC) [ 8 .. 11 ] characters ^[A-Z-a-z0-9]{4}[A-Z-a-z]{2}[A-Z-a-z0-9]{2}([... The bank identification code (BIC). |
iban_last_chars | string (iban_last_chars) [ 4 .. 34 ] characters [a-zA-Z0-9]{4} The last characters of the IBAN used to pay. |
{- "name": "string",
- "country_code": "string",
- "bic": "string",
- "iban_last_chars": "string"
}
Information needed to pay using MyBank.
name required | string (name) [ 3 .. 300 ] characters The name of the account holder associated with this payment method. |
country_code required | string <ppaas_common_country_code_v2> (country_code) = 2 characters ^([A-Z]{2}|C2)$ The two-character ISO 3166-1 country code. |
object (experience_context_base) Customizes the payer experience during the approval process for the payment. |
{- "name": "string",
- "country_code": "string",
- "experience_context": {
- "brand_name": "string",
- "shipping_preference": "GET_FROM_FILE",
- "locale": "string",
- "return_url": "string",
- "cancel_url": "string"
}
}
The full name representation like Mr J Smith.
The full name representation like Mr J Smith.
"string"
The name of the party.
given_name | string <= 140 characters When the party is a person, the party's given, or first, name. |
surname | string <= 140 characters When the party is a person, the party's surname or family name. Also known as the last name. Required when the party is a person. Use also to store multiple surnames including the matronymic, or mother's, surname. |
{- "given_name": "string",
- "surname": "string"
}
The name of the party.
given_name | string <= 140 characters When the party is a person, the party's given, or first, name. |
surname | string <= 140 characters When the party is a person, the party's surname or family name. Also known as the last name. Required when the party is a person. Use also to store multiple surnames including the matronymic, or mother's, surname. |
{- "given_name": "string",
- "surname": "string"
}
The name of the party.
given_name | string <= 140 characters When the party is a person, the party's given, or first, name. |
surname | string <= 140 characters When the party is a person, the party's surname or family name. Also known as the last name. Required when the party is a person. Use also to store multiple surnames including the matronymic, or mother's, surname. |
{- "given_name": "string",
- "surname": "string"
}
The name of the party.
full_name | string <= 300 characters When the party is a person, the party's full name. |
{- "full_name": "string"
}
The name of the party.
given_name | string <= 140 characters When the party is a person, the party's given, or first, name. |
surname | string <= 140 characters When the party is a person, the party's surname or family name. Also known as the last name. Required when the party is a person. Use also to store multiple surnames including the matronymic, or mother's, surname. |
{- "given_name": "string",
- "surname": "string"
}
The net amount. Returned when the currency of the refund is different from the currency of the PayPal account where the merchant holds their funds.
object (Money) The net amount debited from the merchant's PayPal account. | |
object (Money) The converted payable amount. | |
object (exchange_rate) The exchange rate that determines the amount that was debited from the merchant's PayPal account. |
{- "payable_amount": {
- "currency_code": "str",
- "value": "string"
}, - "converted_amount": {
- "currency_code": "str",
- "value": "string"
}, - "exchange_rate": {
- "value": "string",
- "source_currency": "str",
- "target_currency": "str"
}
}
The Third Party Network token used to fund a payment.
number required | string [ 13 .. 19 ] characters ^[0-9]{13,19}$ Third party network token number. | ||||||||||||||
cryptogram | string [ 28 .. 32 ] characters ^.*$ An Encrypted one-time use value that's sent along with Network Token. This field is not required to be present for recurring transactions. | ||||||||||||||
token_requestor_id | string [ 1 .. 11 ] characters ^[0-9A-Z_]+$ A TRID, or a Token Requestor ID, is an identifier used by merchants to request network tokens from card networks. A TRID is a precursor to obtaining a network token for a credit card primary account number (PAN), and will aid in enabling secure card on file (COF) payments and reducing fraud. | ||||||||||||||
expiry required | string (date_year_month) = 7 characters ^[0-9]{4}-(0[1-9]|1[0-2])$ The card expiration year and month, in Internet date format. | ||||||||||||||
eci_flag | string (eci_flag) [ 1 .. 255 ] characters ^[0-9A-Z_]+$ Electronic Commerce Indicator (ECI). The ECI value is part of the 2 data elements that indicate the transaction was processed electronically. This should be passed on the authorization transaction to the Gateway/Processor.
|
{- "number": "stringstrings",
- "cryptogram": "stringstringstringstringstri",
- "token_requestor_id": "string",
- "expiry": "string",
- "eci_flag": "MASTERCARD_NON_3D_SECURE_TRANSACTION"
}
Reference values used by the card network to identify a transaction.
id required | string [ 9 .. 36 ] characters ^[a-zA-Z0-9-_@.:&+=*^'~#!$%()]+$ Transaction reference id returned by the scheme. For Visa and Amex, this is the "Tran id" field in response. For MasterCard, this is the "BankNet reference id" field in response. For Discover, this is the "NRID" field in response. The pattern we expect for this field from Visa/Amex/CB/Discover is numeric, Mastercard/BNPP is alphanumeric and Paysecure is alphanumeric with special character -. | ||||||||||||||||||||||||||||||||||||||||||||||||||||
date | string = 4 characters ^[0-9]+$ The date that the transaction was authorized by the scheme. This field may not be returned for all networks. MasterCard refers to this field as "BankNet reference date. | ||||||||||||||||||||||||||||||||||||||||||||||||||||
acquirer_reference_number | string [ 1 .. 36 ] characters ^[a-zA-Z0-9]+$ Reference ID issued for the card transaction. This ID can be used to track the transaction across processors, card brands and issuing banks. | ||||||||||||||||||||||||||||||||||||||||||||||||||||
network | string (card_brand) [ 1 .. 255 ] characters ^[A-Z_]+$ Name of the card network through which the transaction was routed.
|
{- "id": "stringstr",
- "date": "stri",
- "acquirer_reference_number": "string",
- "network": "VISA"
}
The order details.
create_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 date and time when the transaction occurred, in Internet date and time format. | ||||||||||||||
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 date and time when the transaction was last updated, in Internet date and time format. | ||||||||||||||
id | string The ID of the order. | ||||||||||||||
Array of objects (Purchase Unit) [ 1 .. 10 ] items An array of purchase units. Each purchase unit establishes a contract between a customer and merchant. Each purchase unit represents either a full or partial order that the customer intends to purchase from the merchant. | |||||||||||||||
Array of objects (Link Description) An array of request-related HATEOAS links. To complete payer approval, use the | |||||||||||||||
object (payment_source_response) The payment source used to fund the payment. | |||||||||||||||
intent | string (checkout_payment_intent) The intent to either capture payment immediately or authorize a payment for an order after order creation.
| ||||||||||||||
object <payer_v1> (payer) The customer who approves and pays for the order. The customer is also known as the payer. | |||||||||||||||
status | string (Order Status) [ 1 .. 255 ] characters ^[0-9A-Z_]+$ The order status.
|
{- "create_time": "stringstringstringst",
- "update_time": "stringstringstringst",
- "id": "string",
- "purchase_units": [
- {
- "reference_id": "string",
- "description": "string",
- "custom_id": "string",
- "invoice_id": "string",
- "id": "string",
- "soft_descriptor": "string",
- "items": [
- {
- "name": "string",
- "quantity": "string",
- "description": "string",
- "sku": "string",
- "category": "DIGITAL_GOODS",
- "unit_amount": {
- "currency_code": "str",
- "value": "string"
}, - "tax": {
- "currency_code": "str",
- "value": "string"
}, - "upc": {
- "type": "UPC-A",
- "code": "string"
}
}
], - "most_recent_errors": [
- null
], - "amount": {
- "currency_code": "str",
- "value": "string",
- "breakdown": {
- "item_total": {
- "currency_code": "str",
- "value": "string"
}, - "shipping": {
- "currency_code": "str",
- "value": "string"
}, - "handling": {
- "currency_code": "str",
- "value": "string"
}, - "tax_total": {
- "currency_code": "str",
- "value": "string"
}, - "insurance": {
- "currency_code": "str",
- "value": "string"
}, - "shipping_discount": {
- "currency_code": "str",
- "value": "string"
}, - "discount": {
- "currency_code": "str",
- "value": "string"
}
}
}, - "payee": {
- "email_address": "string",
- "merchant_id": "stringstrings"
}, - "payment_instruction": {
- "platform_fees": [
- {
- "amount": {
- "currency_code": "str",
- "value": "string"
}, - "payee": {
- "email_address": "string",
- "merchant_id": "stringstrings"
}
}
], - "payee_pricing_tier_id": "string",
- "payee_receivable_fx_rate_id": "string",
- "disbursement_mode": "INSTANT"
}, - "shipping": {
- "type": "SHIPPING",
- "options": [
- {
- "id": "string",
- "label": "string",
- "selected": true,
- "type": "SHIPPING",
- "amount": {
- "currency_code": "str",
- "value": "string"
}
}
], - "name": {
- "full_name": "string"
}, - "phone_number": {
- "country_code": "str",
- "national_number": "string"
}, - "address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}, - "trackers": [
- {
- "id": "string",
- "status": "CANCELLED",
- "items": [
- {
- "name": null,
- "quantity": null,
- "sku": null,
- "url": null,
- "image_url": null,
- "upc": null
}
], - "links": [
- {
- "href": null,
- "rel": null,
- "method": null
}
], - "create_time": "stringstringstringst",
- "update_time": "stringstringstringst"
}
]
}, - "supplementary_data": {
- "card": {
- "level_2": {
- "invoice_id": "string",
- "tax_total": {
- "currency_code": "str",
- "value": "string"
}
}, - "level_3": {
- "ships_from_postal_code": "string",
- "line_items": [
- {
- "name": null,
- "quantity": null,
- "description": null,
- "sku": null,
- "url": null,
- "image_url": null,
- "upc": null,
- "commodity_code": null,
- "unit_of_measure": null,
- "unit_amount": null,
- "tax": null,
- "discount_amount": null,
- "total_amount": null
}
], - "shipping_amount": {
- "currency_code": "str",
- "value": "string"
}, - "duty_amount": {
- "currency_code": "str",
- "value": "string"
}, - "discount_amount": {
- "currency_code": "str",
- "value": "string"
}, - "shipping_address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
}
}
}, - "payments": {
- "authorizations": [
- {
- "status": "CREATED",
- "status_details": {
- "reason": "PENDING_REVIEW"
}, - "id": "string",
- "invoice_id": "string",
- "custom_id": "string",
- "links": [
- {
- "href": null,
- "rel": null,
- "method": null
}
], - "amount": {
- "currency_code": "str",
- "value": "string"
}, - "network_transaction_reference": {
- "id": "stringstr",
- "date": "stri",
- "acquirer_reference_number": "string",
- "network": "VISA"
}, - "seller_protection": {
- "status": "ELIGIBLE",
- "dispute_categories": [
- null
]
}, - "expiration_time": "string",
- "create_time": "stringstringstringst",
- "update_time": "stringstringstringst",
- "processor_response": {
- "avs_code": "A",
- "cvv_code": "E",
- "response_code": "0000",
- "payment_advice_code": "01"
}
}
], - "captures": [
- {
- "status": "COMPLETED",
- "status_details": {
- "reason": "BUYER_COMPLAINT"
}, - "id": "string",
- "invoice_id": "string",
- "custom_id": "string",
- "final_capture": false,
- "disbursement_mode": "INSTANT",
- "links": [
- {
- "href": null,
- "rel": null,
- "method": null
}
], - "amount": {
- "currency_code": "str",
- "value": "string"
}, - "network_transaction_reference": {
- "id": "stringstr",
- "date": "stri",
- "acquirer_reference_number": "string",
- "network": "VISA"
}, - "seller_protection": {
- "status": "ELIGIBLE",
- "dispute_categories": [
- null
]
}, - "seller_receivable_breakdown": {
- "platform_fees": [
- null
], - "gross_amount": {
- "currency_code": null,
- "value": null
}, - "paypal_fee": {
- "currency_code": null,
- "value": null
}, - "paypal_fee_in_receivable_currency": {
- "currency_code": null,
- "value": null
}, - "net_amount": {
- "currency_code": null,
- "value": null
}, - "receivable_amount": {
- "currency_code": null,
- "value": null
}, - "exchange_rate": {
- "value": null,
- "source_currency": null,
- "target_currency": null
}
}, - "processor_response": {
- "avs_code": "A",
- "cvv_code": "E",
- "response_code": "0000",
- "payment_advice_code": "01"
}, - "create_time": "stringstringstringst",
- "update_time": "stringstringstringst"
}
], - "refunds": [
- {
- "status": "CANCELLED",
- "status_details": {
- "reason": "ECHECK"
}, - "id": "string",
- "invoice_id": "string",
- "custom_id": "string",
- "acquirer_reference_number": "string",
- "note_to_payer": "string",
- "seller_payable_breakdown": {
- "platform_fees": [
- null
], - "net_amount_breakdown": [
- null
], - "gross_amount": {
- "currency_code": null,
- "value": null
}, - "paypal_fee": {
- "currency_code": null,
- "value": null
}, - "paypal_fee_in_receivable_currency": {
- "currency_code": null,
- "value": null
}, - "net_amount": {
- "currency_code": null,
- "value": null
}, - "net_amount_in_receivable_currency": {
- "currency_code": null,
- "value": null
}, - "total_refunded_amount": {
- "currency_code": null,
- "value": null
}
}, - "links": [
- {
- "href": null,
- "rel": null,
- "method": null
}
], - "amount": {
- "currency_code": "str",
- "value": "string"
}, - "payer": {
- "email_address": "string",
- "merchant_id": "stringstrings"
}, - "create_time": "stringstringstringst",
- "update_time": "stringstringstringst"
}
]
}
}
], - "links": [
- {
- "href": "string",
- "rel": "string",
- "method": "GET"
}
], - "payment_source": {
- "card": {
- "name": "string",
- "last_digits": "string",
- "available_networks": [
- "VISA"
], - "from_request": {
- "last_digits": "stri",
- "expiry": "string"
}, - "brand": "VISA",
- "type": "CREDIT",
- "authentication_result": {
- "liability_shift": "NO",
- "three_d_secure": {
- "authentication_status": "Y",
- "enrollment_status": "Y"
}
}, - "attributes": {
- "vault": {
- "id": "string",
- "status": "VAULTED",
- "links": [
- {
- "href": "string",
- "rel": "string",
- "method": "GET"
}
], - "customer": {
- "id": "string",
- "email_address": "string",
- "phone": {
- "phone_type": "FAX",
- "phone_number": {
- "national_number": null
}
}, - "merchant_customer_id": "string"
}
}
}, - "expiry": "string",
- "bin_details": {
- "bin": "string",
- "issuing_bank": "string",
- "products": [
- "string"
], - "bin_country_code": "string"
}
}, - "bancontact": {
- "card_last_digits": "stri",
- "name": "string",
- "country_code": "string",
- "bic": "string",
- "iban_last_chars": "string"
}, - "blik": {
- "name": "string",
- "country_code": "string",
- "email": "string",
- "one_click": {
- "consumer_reference": "string"
}
}, - "eps": {
- "name": "string",
- "country_code": "string",
- "bic": "string"
}, - "giropay": {
- "name": "string",
- "country_code": "string",
- "bic": "string"
}, - "ideal": {
- "name": "string",
- "country_code": "string",
- "bic": "string",
- "iban_last_chars": "string"
}, - "mybank": {
- "name": "string",
- "country_code": "string",
- "bic": "string",
- "iban_last_chars": "string"
}, - "p24": {
- "payment_descriptor": "string",
- "method_id": "string",
- "method_description": "string",
- "name": "string",
- "email": "string",
- "country_code": "string"
}, - "sofort": {
- "name": "string",
- "country_code": "string",
- "bic": "string",
- "iban_last_chars": "string"
}, - "trustly": {
- "name": "string",
- "country_code": "string",
- "bic": "string",
- "iban_last_chars": "string"
}, - "venmo": {
- "user_name": "string",
- "attributes": {
- "vault": {
- "id": "string",
- "status": "VAULTED",
- "links": [
- {
- "href": "string",
- "rel": "string",
- "method": "GET"
}
], - "customer": {
- "id": "string"
}
}
}, - "email_address": "string",
- "account_id": "stringstrings",
- "name": {
- "given_name": "string",
- "surname": "string"
}, - "phone_number": {
- "national_number": "string"
}, - "address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
}, - "paypal": {
- "account_status": "VERIFIED",
- "phone_type": "FAX",
- "business_name": "string",
- "attributes": {
- "vault": {
- "id": "string",
- "status": "VAULTED",
- "links": [
- {
- "href": "string",
- "rel": "string",
- "method": "GET"
}
], - "customer": {
- "id": "string",
- "email_address": "string",
- "phone": {
- "phone_type": "FAX",
- "phone_number": {
- "national_number": null
}
}, - "merchant_customer_id": "string"
}
}, - "cobranded_cards": [
- {
- "labels": [
- "string"
], - "payee": {
- "email_address": "string",
- "merchant_id": "stringstrings"
}, - "amount": {
- "currency_code": "str",
- "value": "string"
}
}
]
}, - "email_address": "string",
- "account_id": "stringstrings",
- "name": {
- "given_name": "string",
- "surname": "string"
}, - "phone_number": {
- "national_number": "string"
}, - "birth_date": "stringstri",
- "tax_info": {
- "tax_id": "string",
- "tax_id_type": "BR_CPF"
}, - "address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
}, - "apple_pay": {
- "id": "string",
- "token": "string",
- "name": "string",
- "email_address": "string",
- "phone_number": {
- "national_number": "string"
}, - "card": {
- "name": "string",
- "last_digits": "string",
- "available_networks": [
- "VISA"
], - "from_request": {
- "last_digits": "stri",
- "expiry": "string"
}, - "brand": "VISA",
- "type": "CREDIT",
- "authentication_result": {
- "liability_shift": "NO",
- "three_d_secure": {
- "authentication_status": "Y",
- "enrollment_status": "Y"
}
}, - "attributes": {
- "vault": {
- "id": "string",
- "status": "VAULTED",
- "links": [
- {
- "href": null,
- "rel": null,
- "method": null
}
], - "customer": {
- "id": "string",
- "email_address": "string",
- "phone": {
- "phone_type": null,
- "phone_number": null
}, - "merchant_customer_id": "string"
}
}
}, - "expiry": "string",
- "bin_details": {
- "bin": "string",
- "issuing_bank": "string",
- "products": [
- "string"
], - "bin_country_code": "string"
}, - "billing_address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}, - "country_code": "string"
}, - "attributes": {
- "vault": {
- "id": "string",
- "status": "VAULTED",
- "links": [
- {
- "href": "string",
- "rel": "string",
- "method": "GET"
}
], - "customer": {
- "id": "string"
}
}
}
}, - "google_pay": {
- "name": "string",
- "email_address": "string",
- "phone_number": {
- "country_code": "str",
- "national_number": "string"
}, - "card": {
- "name": "string",
- "last_digits": "stri",
- "type": "CREDIT",
- "brand": "VISA",
- "billing_address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}, - "authentication_result": {
- "liability_shift": "NO",
- "three_d_secure": {
- "authentication_status": "Y",
- "enrollment_status": "Y"
}
}
}
}
}, - "intent": "CAPTURE",
- "payer": {
- "email_address": "string",
- "payer_id": "string",
- "name": {
- "given_name": "string",
- "surname": "string"
}, - "phone": {
- "phone_type": "FAX",
- "phone_number": {
- "national_number": "string"
}
}, - "birth_date": "stringstri",
- "tax_info": {
- "tax_id": "string",
- "tax_id_type": "BR_CPF"
}, - "address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
}, - "status": "CREATED"
}
The authorization of an order request.
object (payment_source) The source of payment for the order, which can be a token or a card. Use this object only if you have not redirected the user after order creation to approve the payment. In such cases, the user-selected payment method in the PayPal flow is implicitly used. |
{- "payment_source": {
- "card": {
- "name": "string",
- "number": "stringstrings",
- "security_code": "stri",
- "expiry": "string",
- "billing_address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}, - "attributes": {
- "customer": {
- "id": "string",
- "email_address": "string",
- "phone": {
- "phone_type": "FAX",
- "phone_number": {
- "national_number": "string"
}
}, - "merchant_customer_id": "string"
}, - "vault": {
- "store_in_vault": "ON_SUCCESS"
}, - "verification": {
- "method": "SCA_ALWAYS"
}
}, - "stored_credential": {
- "payment_initiator": "CUSTOMER",
- "payment_type": "ONE_TIME",
- "usage": "FIRST",
- "previous_network_transaction_reference": {
- "id": "stringstr",
- "date": "stri",
- "acquirer_reference_number": "string",
- "network": "VISA"
}
}, - "vault_id": "string",
- "single_use_token": "string",
- "network_token": {
- "number": "stringstrings",
- "cryptogram": "stringstringstringstringstri",
- "token_requestor_id": "string",
- "expiry": "string",
- "eci_flag": "MASTERCARD_NON_3D_SECURE_TRANSACTION"
}, - "experience_context": {
- "return_url": "string",
- "cancel_url": "string"
}
}, - "token": {
- "id": "string",
- "type": "BILLING_AGREEMENT"
}, - "paypal": {
- "experience_context": {
- "brand_name": "string",
- "shipping_preference": "GET_FROM_FILE",
- "landing_page": "LOGIN",
- "user_action": "CONTINUE",
- "payment_method_preference": "UNRESTRICTED",
- "locale": "string",
- "return_url": "string",
- "cancel_url": "string"
}, - "billing_agreement_id": "string",
- "vault_id": "string",
- "email_address": "string",
- "name": {
- "given_name": "string",
- "surname": "string"
}, - "phone": {
- "phone_type": "FAX",
- "phone_number": {
- "national_number": "string"
}
}, - "birth_date": "stringstri",
- "tax_info": {
- "tax_id": "string",
- "tax_id_type": "BR_CPF"
}, - "address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}, - "attributes": {
- "customer": {
- "id": "string",
- "email_address": "string",
- "merchant_customer_id": "string"
}, - "vault": {
- "store_in_vault": "ON_SUCCESS",
- "description": "string",
- "usage_pattern": "string",
- "usage_type": "string",
- "customer_type": "CONSUMER",
- "permit_multiple_payment_tokens": false
}
}
}, - "apple_pay": {
- "id": "string",
- "stored_credential": {
- "payment_initiator": "CUSTOMER",
- "payment_type": "ONE_TIME",
- "usage": "FIRST",
- "previous_network_transaction_reference": {
- "id": "stringstr",
- "date": "stri",
- "acquirer_reference_number": "string",
- "network": "VISA"
}
}, - "attributes": {
- "customer": {
- "id": "string",
- "email_address": "string",
- "phone": {
- "phone_type": "FAX",
- "phone_number": {
- "national_number": "string"
}
}
}, - "vault": {
- "store_in_vault": "ON_SUCCESS"
}
}, - "name": "string",
- "email_address": "string",
- "phone_number": {
- "national_number": "string"
}, - "decrypted_token": {
- "device_manufacturer_id": "string",
- "payment_data_type": "3DSECURE",
- "transaction_amount": {
- "currency_code": "str",
- "value": "string"
}, - "tokenized_card": {
- "name": "string",
- "number": "stringstrings",
- "expiry": "string",
- "card_type": "VISA",
- "type": "CREDIT",
- "brand": "VISA",
- "billing_address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
}, - "payment_data": {
- "cryptogram": "string",
- "eci_indicator": "string",
- "emv_data": "string",
- "pin": "string"
}
}, - "vault_id": "string"
}, - "google_pay": {
- "name": "string",
- "email_address": "string",
- "phone_number": {
- "country_code": "str",
- "national_number": "string"
}, - "card": {
- "name": "string",
- "type": "CREDIT",
- "brand": "VISA",
- "billing_address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
}, - "decrypted_token": {
- "message_id": "string",
- "message_expiration": "stringstrings",
- "payment_method": "CARD",
- "authentication_method": "PAN_ONLY",
- "cryptogram": "string",
- "eci_indicator": "string",
- "card": {
- "name": "string",
- "number": "stringstrings",
- "last_digits": "stri",
- "expiry": "string",
- "type": "CREDIT",
- "brand": "VISA",
- "billing_address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
}
}, - "assurance_details": {
- "account_verified": false,
- "card_holder_authenticated": false
}, - "attributes": {
- "verification": {
- "method": "SCA_ALWAYS"
}
}
}, - "venmo": {
- "experience_context": {
- "brand_name": "string",
- "shipping_preference": "GET_FROM_FILE"
}, - "vault_id": "string",
- "email_address": "string",
- "attributes": {
- "customer": {
- "id": "string",
- "email_address": "string"
}, - "vault": {
- "store_in_vault": "ON_SUCCESS",
- "description": "string",
- "usage_pattern": "string",
- "usage_type": "string",
- "customer_type": "CONSUMER",
- "permit_multiple_payment_tokens": false
}
}
}
}
}
The order authorize response.
create_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 date and time when the transaction occurred, in Internet date and time format. | ||||||||||||||
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 date and time when the transaction was last updated, in Internet date and time format. | ||||||||||||||
id | string The ID of the order. | ||||||||||||||
Array of objects (Purchase Unit) [ 1 .. 10 ] items An array of purchase units. Each purchase unit establishes a contract between a customer and merchant. Each purchase unit represents either a full or partial order that the customer intends to purchase from the merchant. | |||||||||||||||
Array of objects (Link Description) An array of request-related HATEOAS links. To complete payer approval, use the | |||||||||||||||
object (payment_source_response) The payment source used to fund the payment. | |||||||||||||||
intent | string (checkout_payment_intent) The intent to either capture payment immediately or authorize a payment for an order after order creation.
| ||||||||||||||
object <payer_v1> (payer) The customer who approves and pays for the order. The customer is also known as the payer. | |||||||||||||||
status | string (Order Status) [ 1 .. 255 ] characters ^[0-9A-Z_]+$ The order status.
|
{- "create_time": "stringstringstringst",
- "update_time": "stringstringstringst",
- "id": "string",
- "purchase_units": [
- {
- "reference_id": "string",
- "description": "string",
- "custom_id": "string",
- "invoice_id": "string",
- "id": "string",
- "soft_descriptor": "string",
- "items": [
- {
- "name": "string",
- "quantity": "string",
- "description": "string",
- "sku": "string",
- "category": "DIGITAL_GOODS",
- "unit_amount": {
- "currency_code": "str",
- "value": "string"
}, - "tax": {
- "currency_code": "str",
- "value": "string"
}, - "upc": {
- "type": "UPC-A",
- "code": "string"
}
}
], - "most_recent_errors": [
- null
], - "amount": {
- "currency_code": "str",
- "value": "string",
- "breakdown": {
- "item_total": {
- "currency_code": "str",
- "value": "string"
}, - "shipping": {
- "currency_code": "str",
- "value": "string"
}, - "handling": {
- "currency_code": "str",
- "value": "string"
}, - "tax_total": {
- "currency_code": "str",
- "value": "string"
}, - "insurance": {
- "currency_code": "str",
- "value": "string"
}, - "shipping_discount": {
- "currency_code": "str",
- "value": "string"
}, - "discount": {
- "currency_code": "str",
- "value": "string"
}
}
}, - "payee": {
- "email_address": "string",
- "merchant_id": "stringstrings"
}, - "payment_instruction": {
- "platform_fees": [
- {
- "amount": {
- "currency_code": "str",
- "value": "string"
}, - "payee": {
- "email_address": "string",
- "merchant_id": "stringstrings"
}
}
], - "payee_pricing_tier_id": "string",
- "payee_receivable_fx_rate_id": "string",
- "disbursement_mode": "INSTANT"
}, - "shipping": {
- "type": "SHIPPING",
- "options": [
- {
- "id": "string",
- "label": "string",
- "selected": true,
- "type": "SHIPPING",
- "amount": {
- "currency_code": "str",
- "value": "string"
}
}
], - "name": {
- "full_name": "string"
}, - "phone_number": {
- "country_code": "str",
- "national_number": "string"
}, - "address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}, - "trackers": [
- {
- "id": "string",
- "status": "CANCELLED",
- "items": [
- {
- "name": null,
- "quantity": null,
- "sku": null,
- "url": null,
- "image_url": null,
- "upc": null
}
], - "links": [
- {
- "href": null,
- "rel": null,
- "method": null
}
], - "create_time": "stringstringstringst",
- "update_time": "stringstringstringst"
}
]
}, - "supplementary_data": {
- "card": {
- "level_2": {
- "invoice_id": "string",
- "tax_total": {
- "currency_code": "str",
- "value": "string"
}
}, - "level_3": {
- "ships_from_postal_code": "string",
- "line_items": [
- {
- "name": null,
- "quantity": null,
- "description": null,
- "sku": null,
- "url": null,
- "image_url": null,
- "upc": null,
- "commodity_code": null,
- "unit_of_measure": null,
- "unit_amount": null,
- "tax": null,
- "discount_amount": null,
- "total_amount": null
}
], - "shipping_amount": {
- "currency_code": "str",
- "value": "string"
}, - "duty_amount": {
- "currency_code": "str",
- "value": "string"
}, - "discount_amount": {
- "currency_code": "str",
- "value": "string"
}, - "shipping_address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
}
}
}, - "payments": {
- "authorizations": [
- {
- "status": "CREATED",
- "status_details": {
- "reason": "PENDING_REVIEW"
}, - "id": "string",
- "invoice_id": "string",
- "custom_id": "string",
- "links": [
- {
- "href": null,
- "rel": null,
- "method": null
}
], - "amount": {
- "currency_code": "str",
- "value": "string"
}, - "network_transaction_reference": {
- "id": "stringstr",
- "date": "stri",
- "acquirer_reference_number": "string",
- "network": "VISA"
}, - "seller_protection": {
- "status": "ELIGIBLE",
- "dispute_categories": [
- null
]
}, - "expiration_time": "string",
- "create_time": "stringstringstringst",
- "update_time": "stringstringstringst",
- "processor_response": {
- "avs_code": "A",
- "cvv_code": "E",
- "response_code": "0000",
- "payment_advice_code": "01"
}
}
], - "captures": [
- {
- "status": "COMPLETED",
- "status_details": {
- "reason": "BUYER_COMPLAINT"
}, - "id": "string",
- "invoice_id": "string",
- "custom_id": "string",
- "final_capture": false,
- "disbursement_mode": "INSTANT",
- "links": [
- {
- "href": null,
- "rel": null,
- "method": null
}
], - "amount": {
- "currency_code": "str",
- "value": "string"
}, - "network_transaction_reference": {
- "id": "stringstr",
- "date": "stri",
- "acquirer_reference_number": "string",
- "network": "VISA"
}, - "seller_protection": {
- "status": "ELIGIBLE",
- "dispute_categories": [
- null
]
}, - "seller_receivable_breakdown": {
- "platform_fees": [
- null
], - "gross_amount": {
- "currency_code": null,
- "value": null
}, - "paypal_fee": {
- "currency_code": null,
- "value": null
}, - "paypal_fee_in_receivable_currency": {
- "currency_code": null,
- "value": null
}, - "net_amount": {
- "currency_code": null,
- "value": null
}, - "receivable_amount": {
- "currency_code": null,
- "value": null
}, - "exchange_rate": {
- "value": null,
- "source_currency": null,
- "target_currency": null
}
}, - "processor_response": {
- "avs_code": "A",
- "cvv_code": "E",
- "response_code": "0000",
- "payment_advice_code": "01"
}, - "create_time": "stringstringstringst",
- "update_time": "stringstringstringst"
}
], - "refunds": [
- {
- "status": "CANCELLED",
- "status_details": {
- "reason": "ECHECK"
}, - "id": "string",
- "invoice_id": "string",
- "custom_id": "string",
- "acquirer_reference_number": "string",
- "note_to_payer": "string",
- "seller_payable_breakdown": {
- "platform_fees": [
- null
], - "net_amount_breakdown": [
- null
], - "gross_amount": {
- "currency_code": null,
- "value": null
}, - "paypal_fee": {
- "currency_code": null,
- "value": null
}, - "paypal_fee_in_receivable_currency": {
- "currency_code": null,
- "value": null
}, - "net_amount": {
- "currency_code": null,
- "value": null
}, - "net_amount_in_receivable_currency": {
- "currency_code": null,
- "value": null
}, - "total_refunded_amount": {
- "currency_code": null,
- "value": null
}
}, - "links": [
- {
- "href": null,
- "rel": null,
- "method": null
}
], - "amount": {
- "currency_code": "str",
- "value": "string"
}, - "payer": {
- "email_address": "string",
- "merchant_id": "stringstrings"
}, - "create_time": "stringstringstringst",
- "update_time": "stringstringstringst"
}
]
}
}
], - "links": [
- {
- "href": "string",
- "rel": "string",
- "method": "GET"
}
], - "payment_source": {
- "card": {
- "name": "string",
- "last_digits": "string",
- "available_networks": [
- "VISA"
], - "from_request": {
- "last_digits": "stri",
- "expiry": "string"
}, - "brand": "VISA",
- "type": "CREDIT",
- "authentication_result": {
- "liability_shift": "NO",
- "three_d_secure": {
- "authentication_status": "Y",
- "enrollment_status": "Y"
}
}, - "attributes": {
- "vault": {
- "id": "string",
- "status": "VAULTED",
- "links": [
- {
- "href": "string",
- "rel": "string",
- "method": "GET"
}
], - "customer": {
- "id": "string",
- "email_address": "string",
- "phone": {
- "phone_type": "FAX",
- "phone_number": {
- "national_number": null
}
}, - "merchant_customer_id": "string"
}
}
}, - "expiry": "string",
- "bin_details": {
- "bin": "string",
- "issuing_bank": "string",
- "products": [
- "string"
], - "bin_country_code": "string"
}
}, - "venmo": {
- "user_name": "string",
- "attributes": {
- "vault": {
- "id": "string",
- "status": "VAULTED",
- "links": [
- {
- "href": "string",
- "rel": "string",
- "method": "GET"
}
], - "customer": {
- "id": "string"
}
}
}, - "email_address": "string",
- "account_id": "stringstrings",
- "name": {
- "given_name": "string",
- "surname": "string"
}, - "phone_number": {
- "national_number": "string"
}, - "address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
}, - "paypal": {
- "account_status": "VERIFIED",
- "phone_type": "FAX",
- "business_name": "string",
- "attributes": {
- "vault": {
- "id": "string",
- "status": "VAULTED",
- "links": [
- {
- "href": "string",
- "rel": "string",
- "method": "GET"
}
], - "customer": {
- "id": "string",
- "email_address": "string",
- "phone": {
- "phone_type": "FAX",
- "phone_number": {
- "national_number": null
}
}, - "merchant_customer_id": "string"
}
}, - "cobranded_cards": [
- {
- "labels": [
- "string"
], - "payee": {
- "email_address": "string",
- "merchant_id": "stringstrings"
}, - "amount": {
- "currency_code": "str",
- "value": "string"
}
}
]
}, - "email_address": "string",
- "account_id": "stringstrings",
- "name": {
- "given_name": "string",
- "surname": "string"
}, - "phone_number": {
- "national_number": "string"
}, - "birth_date": "stringstri",
- "tax_info": {
- "tax_id": "string",
- "tax_id_type": "BR_CPF"
}, - "address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
}, - "apple_pay": {
- "id": "string",
- "token": "string",
- "name": "string",
- "email_address": "string",
- "phone_number": {
- "national_number": "string"
}, - "card": {
- "name": "string",
- "last_digits": "string",
- "available_networks": [
- "VISA"
], - "from_request": {
- "last_digits": "stri",
- "expiry": "string"
}, - "brand": "VISA",
- "type": "CREDIT",
- "authentication_result": {
- "liability_shift": "NO",
- "three_d_secure": {
- "authentication_status": "Y",
- "enrollment_status": "Y"
}
}, - "attributes": {
- "vault": {
- "id": "string",
- "status": "VAULTED",
- "links": [
- {
- "href": null,
- "rel": null,
- "method": null
}
], - "customer": {
- "id": "string",
- "email_address": "string",
- "phone": {
- "phone_type": null,
- "phone_number": null
}, - "merchant_customer_id": "string"
}
}
}, - "expiry": "string",
- "bin_details": {
- "bin": "string",
- "issuing_bank": "string",
- "products": [
- "string"
], - "bin_country_code": "string"
}, - "billing_address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}, - "country_code": "string"
}, - "attributes": {
- "vault": {
- "id": "string",
- "status": "VAULTED",
- "links": [
- {
- "href": "string",
- "rel": "string",
- "method": "GET"
}
], - "customer": {
- "id": "string"
}
}
}
}, - "google_pay": {
- "name": "string",
- "email_address": "string",
- "phone_number": {
- "country_code": "str",
- "national_number": "string"
}, - "card": {
- "name": "string",
- "last_digits": "stri",
- "type": "CREDIT",
- "brand": "VISA",
- "billing_address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}, - "authentication_result": {
- "liability_shift": "NO",
- "three_d_secure": {
- "authentication_status": "Y",
- "enrollment_status": "Y"
}
}
}
}
}, - "intent": "CAPTURE",
- "payer": {
- "email_address": "string",
- "payer_id": "string",
- "name": {
- "given_name": "string",
- "surname": "string"
}, - "phone": {
- "phone_type": "FAX",
- "phone_number": {
- "national_number": "string"
}
}, - "birth_date": "stringstri",
- "tax_info": {
- "tax_id": "string",
- "tax_id_type": "BR_CPF"
}, - "address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
}, - "status": "CREATED"
}
Completes an capture payment for an order.
object (payment_source) The payment source definition. |
{- "payment_source": {
- "card": {
- "name": "string",
- "number": "stringstrings",
- "security_code": "stri",
- "expiry": "string",
- "billing_address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}, - "attributes": {
- "customer": {
- "id": "string",
- "email_address": "string",
- "phone": {
- "phone_type": "FAX",
- "phone_number": {
- "national_number": "string"
}
}, - "merchant_customer_id": "string"
}, - "vault": {
- "store_in_vault": "ON_SUCCESS"
}, - "verification": {
- "method": "SCA_ALWAYS"
}
}, - "stored_credential": {
- "payment_initiator": "CUSTOMER",
- "payment_type": "ONE_TIME",
- "usage": "FIRST",
- "previous_network_transaction_reference": {
- "id": "stringstr",
- "date": "stri",
- "acquirer_reference_number": "string",
- "network": "VISA"
}
}, - "vault_id": "string",
- "single_use_token": "string",
- "network_token": {
- "number": "stringstrings",
- "cryptogram": "stringstringstringstringstri",
- "token_requestor_id": "string",
- "expiry": "string",
- "eci_flag": "MASTERCARD_NON_3D_SECURE_TRANSACTION"
}, - "experience_context": {
- "return_url": "string",
- "cancel_url": "string"
}
}, - "token": {
- "id": "string",
- "type": "BILLING_AGREEMENT"
}, - "paypal": {
- "experience_context": {
- "brand_name": "string",
- "shipping_preference": "GET_FROM_FILE",
- "landing_page": "LOGIN",
- "user_action": "CONTINUE",
- "payment_method_preference": "UNRESTRICTED",
- "locale": "string",
- "return_url": "string",
- "cancel_url": "string"
}, - "billing_agreement_id": "string",
- "vault_id": "string",
- "email_address": "string",
- "name": {
- "given_name": "string",
- "surname": "string"
}, - "phone": {
- "phone_type": "FAX",
- "phone_number": {
- "national_number": "string"
}
}, - "birth_date": "stringstri",
- "tax_info": {
- "tax_id": "string",
- "tax_id_type": "BR_CPF"
}, - "address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}, - "attributes": {
- "customer": {
- "id": "string",
- "email_address": "string",
- "merchant_customer_id": "string"
}, - "vault": {
- "store_in_vault": "ON_SUCCESS",
- "description": "string",
- "usage_pattern": "string",
- "usage_type": "string",
- "customer_type": "CONSUMER",
- "permit_multiple_payment_tokens": false
}
}
}, - "apple_pay": {
- "id": "string",
- "stored_credential": {
- "payment_initiator": "CUSTOMER",
- "payment_type": "ONE_TIME",
- "usage": "FIRST",
- "previous_network_transaction_reference": {
- "id": "stringstr",
- "date": "stri",
- "acquirer_reference_number": "string",
- "network": "VISA"
}
}, - "attributes": {
- "customer": {
- "id": "string",
- "email_address": "string",
- "phone": {
- "phone_type": "FAX",
- "phone_number": {
- "national_number": "string"
}
}
}, - "vault": {
- "store_in_vault": "ON_SUCCESS"
}
}, - "name": "string",
- "email_address": "string",
- "phone_number": {
- "national_number": "string"
}, - "decrypted_token": {
- "device_manufacturer_id": "string",
- "payment_data_type": "3DSECURE",
- "transaction_amount": {
- "currency_code": "str",
- "value": "string"
}, - "tokenized_card": {
- "name": "string",
- "number": "stringstrings",
- "expiry": "string",
- "card_type": "VISA",
- "type": "CREDIT",
- "brand": "VISA",
- "billing_address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
}, - "payment_data": {
- "cryptogram": "string",
- "eci_indicator": "string",
- "emv_data": "string",
- "pin": "string"
}
}, - "vault_id": "string"
}, - "google_pay": {
- "name": "string",
- "email_address": "string",
- "phone_number": {
- "country_code": "str",
- "national_number": "string"
}, - "card": {
- "name": "string",
- "type": "CREDIT",
- "brand": "VISA",
- "billing_address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
}, - "decrypted_token": {
- "message_id": "string",
- "message_expiration": "stringstrings",
- "payment_method": "CARD",
- "authentication_method": "PAN_ONLY",
- "cryptogram": "string",
- "eci_indicator": "string",
- "card": {
- "name": "string",
- "number": "stringstrings",
- "last_digits": "stri",
- "expiry": "string",
- "type": "CREDIT",
- "brand": "VISA",
- "billing_address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
}
}, - "assurance_details": {
- "account_verified": false,
- "card_holder_authenticated": false
}, - "attributes": {
- "verification": {
- "method": "SCA_ALWAYS"
}
}
}, - "venmo": {
- "experience_context": {
- "brand_name": "string",
- "shipping_preference": "GET_FROM_FILE"
}, - "vault_id": "string",
- "email_address": "string",
- "attributes": {
- "customer": {
- "id": "string",
- "email_address": "string"
}, - "vault": {
- "store_in_vault": "ON_SUCCESS",
- "description": "string",
- "usage_pattern": "string",
- "usage_type": "string",
- "customer_type": "CONSUMER",
- "permit_multiple_payment_tokens": false
}
}
}
}
}
Customizes the payer confirmation experience.
brand_name | string [ 1 .. 127 ] characters Label to present to your payer as part of the PayPal hosted web experience. |
return_url | string <uri> [ 10 .. 4000 ] characters The URL where the customer is redirected after the customer approves the payment. |
cancel_url | string <uri> [ 10 .. 4000 ] characters The URL where the customer is redirected after the customer cancels the payment. |
locale | string <ppaas_common_language_v3> (language) [ 2 .. 10 ] characters ^[a-z]{2}(?:-[A-Z][a-z]{3})?(?:-(?:[A-Z]{2}|[... The BCP 47-formatted locale of pages that the PayPal payment experience shows. PayPal supports a five-character code. For example, |
object (stored_payment_source) Provides additional details to process a payment using a
|
{- "brand_name": "string",
- "locale": "string",
- "stored_payment_source": {
- "payment_initiator": "CUSTOMER",
- "payment_type": "ONE_TIME",
- "usage": "FIRST",
- "previous_network_transaction_reference": {
- "id": "stringstr",
- "date": "stri",
- "acquirer_reference_number": "string",
- "network": "VISA"
}
}
}
The order request details.
required | Array of objects (Purchase Unit Request) [ 1 .. 10 ] items An array of purchase units. Each purchase unit establishes a contract between a payer and the payee. Each purchase unit represents either a full or partial order that the payer intends to purchase from the payee. | ||||||
intent required | string (checkout_payment_intent) The intent to either capture payment immediately or authorize a payment for an order after order creation.
| ||||||
object <payer_v1> (payer) DEPRECATED. The customer is also known as the payer. The Payer object was intended to only be used with the | |||||||
object (payment_source) The payment source definition. | |||||||
object (application_context) Customize the payer experience during the approval process for the payment with PayPal. |
{- "purchase_units": [
- {
- "reference_id": "string",
- "description": "string",
- "custom_id": "string",
- "invoice_id": "string",
- "soft_descriptor": "string",
- "items": [
- {
- "name": "string",
- "quantity": "string",
- "description": "string",
- "sku": "string",
- "category": "DIGITAL_GOODS",
- "unit_amount": {
- "currency_code": "str",
- "value": "string"
}, - "tax": {
- "currency_code": "str",
- "value": "string"
}, - "upc": {
- "type": "UPC-A",
- "code": "string"
}
}
], - "amount": {
- "currency_code": "str",
- "value": "string",
- "breakdown": {
- "item_total": {
- "currency_code": "str",
- "value": "string"
}, - "shipping": {
- "currency_code": "str",
- "value": "string"
}, - "handling": {
- "currency_code": "str",
- "value": "string"
}, - "tax_total": {
- "currency_code": "str",
- "value": "string"
}, - "insurance": {
- "currency_code": "str",
- "value": "string"
}, - "shipping_discount": {
- "currency_code": "str",
- "value": "string"
}, - "discount": {
- "currency_code": "str",
- "value": "string"
}
}
}, - "payee": {
- "email_address": "string",
- "merchant_id": "stringstrings"
}, - "payment_instruction": {
- "platform_fees": [
- {
- "amount": {
- "currency_code": "str",
- "value": "string"
}, - "payee": {
- "email_address": "string",
- "merchant_id": "stringstrings"
}
}
], - "payee_pricing_tier_id": "string",
- "payee_receivable_fx_rate_id": "string",
- "disbursement_mode": "INSTANT"
}, - "shipping": {
- "type": "SHIPPING",
- "options": [
- {
- "id": "string",
- "label": "string",
- "selected": true,
- "type": "SHIPPING",
- "amount": {
- "currency_code": "str",
- "value": "string"
}
}
], - "name": {
- "full_name": "string"
}, - "phone_number": {
- "country_code": "str",
- "national_number": "string"
}, - "address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
}, - "supplementary_data": {
- "card": {
- "level_2": {
- "invoice_id": "string",
- "tax_total": {
- "currency_code": "str",
- "value": "string"
}
}, - "level_3": {
- "ships_from_postal_code": "string",
- "line_items": [
- {
- "name": null,
- "quantity": null,
- "description": null,
- "sku": null,
- "url": null,
- "image_url": null,
- "upc": null,
- "commodity_code": null,
- "unit_of_measure": null,
- "unit_amount": null,
- "tax": null,
- "discount_amount": null,
- "total_amount": null
}
], - "shipping_amount": {
- "currency_code": "str",
- "value": "string"
}, - "duty_amount": {
- "currency_code": "str",
- "value": "string"
}, - "discount_amount": {
- "currency_code": "str",
- "value": "string"
}, - "shipping_address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
}
}
}
}
], - "intent": "CAPTURE",
- "payer": {
- "email_address": "string",
- "payer_id": "string",
- "name": {
- "given_name": "string",
- "surname": "string"
}, - "phone": {
- "phone_type": "FAX",
- "phone_number": {
- "national_number": "string"
}
}, - "birth_date": "stringstri",
- "tax_info": {
- "tax_id": "string",
- "tax_id_type": "BR_CPF"
}, - "address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
}, - "payment_source": {
- "card": {
- "name": "string",
- "number": "stringstrings",
- "security_code": "stri",
- "expiry": "string",
- "billing_address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}, - "attributes": {
- "customer": {
- "id": "string",
- "email_address": "string",
- "phone": {
- "phone_type": "FAX",
- "phone_number": {
- "national_number": "string"
}
}, - "merchant_customer_id": "string"
}, - "vault": {
- "store_in_vault": "ON_SUCCESS"
}, - "verification": {
- "method": "SCA_ALWAYS"
}
}, - "stored_credential": {
- "payment_initiator": "CUSTOMER",
- "payment_type": "ONE_TIME",
- "usage": "FIRST",
- "previous_network_transaction_reference": {
- "id": "stringstr",
- "date": "stri",
- "acquirer_reference_number": "string",
- "network": "VISA"
}
}, - "vault_id": "string",
- "single_use_token": "string",
- "network_token": {
- "number": "stringstrings",
- "cryptogram": "stringstringstringstringstri",
- "token_requestor_id": "string",
- "expiry": "string",
- "eci_flag": "MASTERCARD_NON_3D_SECURE_TRANSACTION"
}, - "experience_context": {
- "return_url": "string",
- "cancel_url": "string"
}
}, - "token": {
- "id": "string",
- "type": "BILLING_AGREEMENT"
}, - "paypal": {
- "experience_context": {
- "brand_name": "string",
- "shipping_preference": "GET_FROM_FILE",
- "landing_page": "LOGIN",
- "user_action": "CONTINUE",
- "payment_method_preference": "UNRESTRICTED",
- "locale": "string",
- "return_url": "string",
- "cancel_url": "string"
}, - "billing_agreement_id": "string",
- "vault_id": "string",
- "email_address": "string",
- "name": {
- "given_name": "string",
- "surname": "string"
}, - "phone": {
- "phone_type": "FAX",
- "phone_number": {
- "national_number": "string"
}
}, - "birth_date": "stringstri",
- "tax_info": {
- "tax_id": "string",
- "tax_id_type": "BR_CPF"
}, - "address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}, - "attributes": {
- "customer": {
- "id": "string",
- "email_address": "string",
- "merchant_customer_id": "string"
}, - "vault": {
- "store_in_vault": "ON_SUCCESS",
- "description": "string",
- "usage_pattern": "string",
- "usage_type": "string",
- "customer_type": "CONSUMER",
- "permit_multiple_payment_tokens": false
}
}
}, - "bancontact": {
- "name": "string",
- "country_code": "string",
- "experience_context": {
- "brand_name": "string",
- "shipping_preference": "GET_FROM_FILE",
- "locale": "string",
- "return_url": "string",
- "cancel_url": "string"
}
}, - "blik": {
- "name": "string",
- "country_code": "string",
- "email": "string",
- "experience_context": {
- "brand_name": "string",
- "shipping_preference": "GET_FROM_FILE",
- "locale": "string",
- "return_url": "string",
- "cancel_url": "string",
- "consumer_user_agent": "string",
- "consumer_ip": "string"
}, - "level_0": {
- "auth_code": "string"
}, - "one_click": {
- "auth_code": "string",
- "consumer_reference": "string",
- "alias_label": "stringst",
- "alias_key": "string"
}
}, - "eps": {
- "name": "string",
- "country_code": "string",
- "experience_context": {
- "brand_name": "string",
- "shipping_preference": "GET_FROM_FILE",
- "locale": "string",
- "return_url": "string",
- "cancel_url": "string"
}
}, - "giropay": {
- "name": "string",
- "country_code": "string",
- "experience_context": {
- "brand_name": "string",
- "shipping_preference": "GET_FROM_FILE",
- "locale": "string",
- "return_url": "string",
- "cancel_url": "string"
}
}, - "ideal": {
- "name": "string",
- "country_code": "string",
- "bic": "string",
- "experience_context": {
- "brand_name": "string",
- "shipping_preference": "GET_FROM_FILE",
- "locale": "string",
- "return_url": "string",
- "cancel_url": "string"
}
}, - "mybank": {
- "name": "string",
- "country_code": "string",
- "experience_context": {
- "brand_name": "string",
- "shipping_preference": "GET_FROM_FILE",
- "locale": "string",
- "return_url": "string",
- "cancel_url": "string"
}
}, - "p24": {
- "name": "string",
- "email": "string",
- "country_code": "string",
- "experience_context": {
- "brand_name": "string",
- "shipping_preference": "GET_FROM_FILE",
- "locale": "string",
- "return_url": "string",
- "cancel_url": "string"
}
}, - "sofort": {
- "name": "string",
- "country_code": "string",
- "experience_context": {
- "brand_name": "string",
- "shipping_preference": "GET_FROM_FILE",
- "locale": "string",
- "return_url": "string",
- "cancel_url": "string"
}
}, - "trustly": {
- "name": "string",
- "country_code": "string",
- "experience_context": {
- "brand_name": "string",
- "shipping_preference": "GET_FROM_FILE",
- "locale": "string",
- "return_url": "string",
- "cancel_url": "string"
}
}, - "apple_pay": {
- "id": "string",
- "stored_credential": {
- "payment_initiator": "CUSTOMER",
- "payment_type": "ONE_TIME",
- "usage": "FIRST",
- "previous_network_transaction_reference": {
- "id": "stringstr",
- "date": "stri",
- "acquirer_reference_number": "string",
- "network": "VISA"
}
}, - "attributes": {
- "customer": {
- "id": "string",
- "email_address": "string",
- "phone": {
- "phone_type": "FAX",
- "phone_number": {
- "national_number": "string"
}
}
}, - "vault": {
- "store_in_vault": "ON_SUCCESS"
}
}, - "name": "string",
- "email_address": "string",
- "phone_number": {
- "national_number": "string"
}, - "decrypted_token": {
- "device_manufacturer_id": "string",
- "payment_data_type": "3DSECURE",
- "transaction_amount": {
- "currency_code": "str",
- "value": "string"
}, - "tokenized_card": {
- "name": "string",
- "number": "stringstrings",
- "expiry": "string",
- "card_type": "VISA",
- "type": "CREDIT",
- "brand": "VISA",
- "billing_address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
}, - "payment_data": {
- "cryptogram": "string",
- "eci_indicator": "string",
- "emv_data": "string",
- "pin": "string"
}
}, - "vault_id": "string"
}, - "google_pay": {
- "name": "string",
- "email_address": "string",
- "phone_number": {
- "country_code": "str",
- "national_number": "string"
}, - "card": {
- "name": "string",
- "type": "CREDIT",
- "brand": "VISA",
- "billing_address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
}, - "decrypted_token": {
- "message_id": "string",
- "message_expiration": "stringstrings",
- "payment_method": "CARD",
- "authentication_method": "PAN_ONLY",
- "cryptogram": "string",
- "eci_indicator": "string",
- "card": {
- "name": "string",
- "number": "stringstrings",
- "last_digits": "stri",
- "expiry": "string",
- "type": "CREDIT",
- "brand": "VISA",
- "billing_address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
}
}, - "assurance_details": {
- "account_verified": false,
- "card_holder_authenticated": false
}, - "attributes": {
- "verification": {
- "method": "SCA_ALWAYS"
}
}
}, - "venmo": {
- "experience_context": {
- "brand_name": "string",
- "shipping_preference": "GET_FROM_FILE"
}, - "vault_id": "string",
- "email_address": "string",
- "attributes": {
- "customer": {
- "id": "string",
- "email_address": "string"
}, - "vault": {
- "store_in_vault": "ON_SUCCESS",
- "description": "string",
- "usage_pattern": "string",
- "usage_type": "string",
- "customer_type": "CONSUMER",
- "permit_multiple_payment_tokens": false
}
}
}
}, - "application_context": {
- "brand_name": "string",
- "landing_page": "LOGIN",
- "shipping_preference": "GET_FROM_FILE",
- "user_action": "CONTINUE",
- "locale": "string",
- "payment_method": {
- "standard_entry_class_code": "TEL",
- "payee_preferred": "UNRESTRICTED"
}, - "stored_payment_source": {
- "payment_initiator": "CUSTOMER",
- "payment_type": "ONE_TIME",
- "usage": "FIRST",
- "previous_network_transaction_reference": {
- "id": "stringstr",
- "date": "stri",
- "acquirer_reference_number": "string",
- "network": "VISA"
}
}
}
}
The order status.
The order status.
Enum: | Description |
---|---|
CREATED | The order was created with the specified context. |
SAVED | The order was saved and persisted. The order status continues to be in progress until a capture is made with |
APPROVED | The customer approved the payment through the PayPal wallet or another form of guest or unbranded payment. For example, a card, bank account, or so on. |
VOIDED | All purchase units in the order are voided. |
COMPLETED | The payment was authorized or the authorized payment was captured for the order. |
PAYER_ACTION_REQUIRED | The order requires an action from the payer (e.g. 3DS authentication). Redirect the payer to the "rel":"payer-action" HATEOAS link returned as part of the response prior to authorizing or capturing the order. Some payment sources may not return a payer-action HATEOAS link (eg. MB WAY). For these payment sources the payer-action is managed by the scheme itself (eg. through SMS, email, in-app notification, etc). |
"CREATED"
Information used to pay using P24(Przelewy24).
payment_descriptor | string [ 1 .. 2000 ] characters P24 generated payment description. |
method_id | string [ 1 .. 300 ] characters Numeric identifier of the payment scheme or bank used for the payment. |
method_description | string [ 1 .. 2000 ] characters Friendly name of the payment scheme or bank used for the payment. |
name | string (name) [ 3 .. 300 ] characters The name of the account holder associated with this payment method. |
string <ppaas_common_email_address_v2> (email_address) [ 3 .. 254 ] characters ^(?:[A-Za-z0-9!#$%&'*+/=?^_`{|}~-]+(?:\.[A-Za... The email address of the account holder associated with this payment method. | |
country_code | string <ppaas_common_country_code_v2> (country_code) = 2 characters ^([A-Z]{2}|C2)$ The two-character ISO 3166-1 country code. |
{- "payment_descriptor": "string",
- "method_id": "string",
- "method_description": "string",
- "name": "string",
- "email": "string",
- "country_code": "string"
}
Information needed to pay using P24 (Przelewy24).
name required | string (name) [ 3 .. 300 ] characters The name of the account holder associated with this payment method. |
email required | string <ppaas_common_email_address_v2> (email_address) [ 3 .. 254 ] characters ^(?:[A-Za-z0-9!#$%&'*+/=?^_`{|}~-]+(?:\.[A-Za... The email address of the account holder associated with this payment method. |
country_code required | string <ppaas_common_country_code_v2> (country_code) = 2 characters ^([A-Z]{2}|C2)$ The two-character ISO 3166-1 country code. |
object (experience_context_base) Customizes the payer experience during the approval process for the payment. |
{- "name": "string",
- "email": "string",
- "country_code": "string",
- "experience_context": {
- "brand_name": "string",
- "shipping_preference": "GET_FROM_FILE",
- "locale": "string",
- "return_url": "string",
- "cancel_url": "string"
}
}
Transactions status result identifier. The outcome of the issuer's authentication.
Transactions status result identifier. The outcome of the issuer's authentication.
Enum: | Description |
---|---|
Y | Successful authentication. |
N | Failed authentication / account not verified / transaction denied. |
U | Unable to complete authentication. |
A | Successful attempts transaction. |
C | Challenge required for authentication. |
R | Authentication rejected (merchant must not submit for authorization). |
D | Challenge required; decoupled authentication confirmed. |
I | Informational only; 3DS requestor challenge preference acknowledged. |
"Y"
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"
}
An array of JSON patch objects 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"
}
]
The merchant who receives the funds and fulfills the order. The merchant is also known as the payee.
email_address | string <merchant_common_email_address_v2> (email) [ 3 .. 254 ] characters (?:[a-zA-Z0-9!#$%&'*+/=?^_`{|}~-]+(?:\.[a-zA-... The email address of merchant. |
merchant_id | string <ppaas_payer_id_v3> (PayPal Account Identifier) = 13 characters ^[2-9A-HJ-NP-Z]{13}$ The encrypted PayPal account ID of the merchant. |
{- "email_address": "string",
- "merchant_id": "stringstrings"
}
The details for the merchant who receives the funds and fulfills the order. The merchant is also known as the payee.
email_address | string <merchant_common_email_address_v2> (email) [ 3 .. 254 ] characters (?:[a-zA-Z0-9!#$%&'*+/=?^_`{|}~-]+(?:\.[a-zA-... The email address of merchant. |
merchant_id | string <ppaas_payer_id_v3> (PayPal Account Identifier) = 13 characters ^[2-9A-HJ-NP-Z]{13}$ The encrypted PayPal account ID of the merchant. |
{- "email_address": "string",
- "merchant_id": "stringstrings"
}
The details for the merchant who receives the funds and fulfills the order. The merchant is also known as the payee.
email_address | string <merchant_common_email_address_v2> (email) [ 3 .. 254 ] characters (?:[a-zA-Z0-9!#$%&'*+/=?^_`{|}~-]+(?:\.[a-zA-... The email address of merchant. |
merchant_id | string <ppaas_payer_id_v3> (PayPal Account Identifier) = 13 characters ^[2-9A-HJ-NP-Z]{13}$ The encrypted PayPal account ID of the merchant. |
{- "email_address": "string",
- "merchant_id": "stringstrings"
}
The merchant-preferred payment methods.
The merchant-preferred payment methods.
Enum: | Description |
---|---|
UNRESTRICTED | Accepts any type of payment from the customer. |
IMMEDIATE_PAYMENT_REQUIRED | Accepts only immediate payment from the customer. For example, credit card, PayPal balance, or instant ACH. Ensures that at the time of capture, the payment does not have the |
"UNRESTRICTED"
The customer who approves and pays for the order. The customer is also known as the payer.
email_address | string <merchant_common_email_address_v2> (email) [ 3 .. 254 ] characters (?:[a-zA-Z0-9!#$%&'*+/=?^_`{|}~-]+(?:\.[a-zA-... The email address of the payer. |
payer_id | string <ppaas_payer_id_v3> (PayPal Account Identifier) = 13 characters ^[2-9A-HJ-NP-Z]{13}$ The PayPal-assigned ID for the payer. |
object (Name) The name of the payer. Supports only the | |
object (phone_with_type) The phone number of the customer. Available only when you enable the Contact Telephone Number option in the Profile & Settings for the merchant's PayPal account. The | |
birth_date | string <ppaas_date_notime_v2> (date_no_time) = 10 characters ^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|... The birth date of the payer in |
object (tax_info) The tax information of the payer. Required only for Brazilian payer's. Both | |
object (Portable Postal Address (Medium-Grained)) The address of the payer. Supports only the |
{- "email_address": "string",
- "payer_id": "string",
- "name": {
- "given_name": "string",
- "surname": "string"
}, - "phone": {
- "phone_type": "FAX",
- "phone_number": {
- "national_number": "string"
}
}, - "birth_date": "stringstri",
- "tax_info": {
- "tax_id": "string",
- "tax_id_type": "BR_CPF"
}, - "address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
}
The customer who approves and pays for the order. The customer is also known as the payer.
email_address | string <merchant_common_email_address_v2> (email) [ 3 .. 254 ] characters (?:[a-zA-Z0-9!#$%&'*+/=?^_`{|}~-]+(?:\.[a-zA-... The email address of the payer. |
payer_id | string <ppaas_payer_id_v3> (PayPal Account Identifier) = 13 characters ^[2-9A-HJ-NP-Z]{13}$ The PayPal-assigned ID for the payer. |
{- "email_address": "string",
- "payer_id": "string"
}
The collection of payments, or transactions, for a purchase unit in an order. For example, authorized payments, captured payments, and refunds.
Array of objects (authorization_with_additional_data) An array of authorized payments for a purchase unit. A purchase unit can have zero or more authorized payments. | |
Array of objects (capture) An array of captured payments for a purchase unit. A purchase unit can have zero or more captured payments. | |
Array of objects (refund) An array of refunds for a purchase unit. A purchase unit can have zero or more refunds. |
{- "authorizations": [
- {
- "status": "CREATED",
- "status_details": {
- "reason": "PENDING_REVIEW"
}, - "id": "string",
- "invoice_id": "string",
- "custom_id": "string",
- "links": [
- {
- "href": "string",
- "rel": "string",
- "method": "GET"
}
], - "amount": {
- "currency_code": "str",
- "value": "string"
}, - "network_transaction_reference": {
- "id": "stringstr",
- "date": "stri",
- "acquirer_reference_number": "string",
- "network": "VISA"
}, - "seller_protection": {
- "status": "ELIGIBLE",
- "dispute_categories": [
- "string"
]
}, - "expiration_time": "string",
- "create_time": "stringstringstringst",
- "update_time": "stringstringstringst",
- "processor_response": {
- "avs_code": "A",
- "cvv_code": "E",
- "response_code": "0000",
- "payment_advice_code": "01"
}
}
], - "captures": [
- {
- "status": "COMPLETED",
- "status_details": {
- "reason": "BUYER_COMPLAINT"
}, - "id": "string",
- "invoice_id": "string",
- "custom_id": "string",
- "final_capture": false,
- "disbursement_mode": "INSTANT",
- "links": [
- {
- "href": "string",
- "rel": "string",
- "method": "GET"
}
], - "amount": {
- "currency_code": "str",
- "value": "string"
}, - "network_transaction_reference": {
- "id": "stringstr",
- "date": "stri",
- "acquirer_reference_number": "string",
- "network": "VISA"
}, - "seller_protection": {
- "status": "ELIGIBLE",
- "dispute_categories": [
- "string"
]
}, - "seller_receivable_breakdown": {
- "platform_fees": [
- {
- "amount": {
- "currency_code": "str",
- "value": "string"
}, - "payee": {
- "email_address": "string",
- "merchant_id": "stringstrings"
}
}
], - "gross_amount": {
- "currency_code": "str",
- "value": "string"
}, - "paypal_fee": {
- "currency_code": "str",
- "value": "string"
}, - "paypal_fee_in_receivable_currency": {
- "currency_code": "str",
- "value": "string"
}, - "net_amount": {
- "currency_code": "str",
- "value": "string"
}, - "receivable_amount": {
- "currency_code": "str",
- "value": "string"
}, - "exchange_rate": {
- "value": "string",
- "source_currency": "str",
- "target_currency": "str"
}
}, - "processor_response": {
- "avs_code": "A",
- "cvv_code": "E",
- "response_code": "0000",
- "payment_advice_code": "01"
}, - "create_time": "stringstringstringst",
- "update_time": "stringstringstringst"
}
], - "refunds": [
- {
- "status": "CANCELLED",
- "status_details": {
- "reason": "ECHECK"
}, - "id": "string",
- "invoice_id": "string",
- "custom_id": "string",
- "acquirer_reference_number": "string",
- "note_to_payer": "string",
- "seller_payable_breakdown": {
- "platform_fees": [
- {
- "amount": {
- "currency_code": "str",
- "value": "string"
}, - "payee": {
- "email_address": "string",
- "merchant_id": "stringstrings"
}
}
], - "net_amount_breakdown": [
- {
- "payable_amount": {
- "currency_code": "str",
- "value": "string"
}, - "converted_amount": {
- "currency_code": "str",
- "value": "string"
}, - "exchange_rate": {
- "value": "string",
- "source_currency": "str",
- "target_currency": "str"
}
}
], - "gross_amount": {
- "currency_code": "str",
- "value": "string"
}, - "paypal_fee": {
- "currency_code": "str",
- "value": "string"
}, - "paypal_fee_in_receivable_currency": {
- "currency_code": "str",
- "value": "string"
}, - "net_amount": {
- "currency_code": "str",
- "value": "string"
}, - "net_amount_in_receivable_currency": {
- "currency_code": "str",
- "value": "string"
}, - "total_refunded_amount": {
- "currency_code": "str",
- "value": "string"
}
}, - "links": [
- {
- "href": "string",
- "rel": "string",
- "method": "GET"
}
], - "amount": {
- "currency_code": "str",
- "value": "string"
}, - "payer": {
- "email_address": "string",
- "merchant_id": "stringstrings"
}, - "create_time": "stringstringstringst",
- "update_time": "stringstringstringst"
}
]
}
The person or party who initiated or triggered the payment.
The person or party who initiated or triggered the payment.
Enum: | Description |
---|---|
CUSTOMER | Payment is initiated with the active engagement of the customer. e.g. a customer checking out on a merchant website. |
MERCHANT | Payment is initiated by merchant on behalf of the customer without the active engagement of customer. e.g. a merchant charging the monthly payment of a subscription to the customer. |
"CUSTOMER"
Any additional payment instructions to be consider during payment processing. This processing instruction is applicable for Capturing an order or Authorizing an Order.
Array of objects (platform_fee) [ 0 .. 1 ] items An array of various fees, commissions, tips, or donations. This field is only applicable to merchants that been enabled for PayPal Complete Payments Platform for Marketplaces and Platforms capability. | |||||||
payee_pricing_tier_id | string [ 1 .. 20 ] characters ^.*$ This field is only enabled for selected merchants/partners to use and provides the ability to trigger a specific pricing rate/plan for a payment transaction. The list of eligible 'payee_pricing_tier_id' would be provided to you by your Account Manager. Specifying values other than the one provided to you by your account manager would result in an error. | ||||||
payee_receivable_fx_rate_id | string [ 1 .. 4000 ] characters ^.*$ FX identifier generated returned by PayPal to be used for payment processing in order to honor FX rate (for eligible integrations) to be used when amount is settled/received into the payee account. | ||||||
disbursement_mode | string (disbursement_mode) [ 1 .. 16 ] characters ^[A-Z_]+$ Default: "INSTANT" The funds that are held payee by the marketplace/platform. This field is only applicable to merchants that been enabled for PayPal Complete Payments Platform for Marketplaces and Platforms capability.
|
{- "platform_fees": [
- {
- "amount": {
- "currency_code": "str",
- "value": "string"
}, - "payee": {
- "email_address": "string",
- "merchant_id": "stringstrings"
}
}
], - "payee_pricing_tier_id": "string",
- "payee_receivable_fx_rate_id": "string",
- "disbursement_mode": "INSTANT"
}
The customer and merchant payment preferences.
standard_entry_class_code | string [ 3 .. 255 ] characters Default: "WEB" NACHA (the regulatory body governing the ACH network) requires that API callers (merchants, partners) obtain the consumer’s explicit authorization before initiating a transaction. To stay compliant, you’ll need to make sure that you retain a compliant authorization for each transaction that you originate to the ACH Network using this API. ACH transactions are categorized (using SEC codes) by how you capture authorization from the Receiver (the person whose bank account is being debited or credited). PayPal supports the following SEC codes.
| ||||||||||
payee_preferred | string (payee_payment_method_preference) [ 1 .. 255 ] characters ^[0-9A-Z_]+$ Default: "UNRESTRICTED" The merchant-preferred payment methods.
|
{- "standard_entry_class_code": "TEL",
- "payee_preferred": "UNRESTRICTED"
}
The payment source definition.
object (card_request) 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. | |
object (token) The tokenized payment source to fund a payment. | |
object (paypal_wallet) Indicates that PayPal Wallet is the payment source. Main use of this selection is to provide additional instructions associated with this choice like vaulting. | |
object (bancontact_request) Bancontact is the most popular online payment in Belgium. More Details. | |
object (blik_request) BLIK is a mobile payment system, created by Polish Payment Standard in order to allow millions of users to pay in shops, payout cash in ATMs and make online purchases and payments. More Details. | |
object (eps_request) The eps transfer is an online payment method developed by many Austrian banks. More Details. | |
object (giropay_request) Giropay is an Internet payment System in Germany, based on online banking. More Details. | |
object (ideal_request) The Dutch payment method iDEAL is an online payment method that enables consumers to pay online through their own bank. More Details. | |
object (mybank_request) MyBank is an e-authorisation solution which enables safe digital payments and identity authentication through a consumer’s own online banking portal or mobile application. More Details. | |
object (p24_request) P24 (Przelewy24) is a secure and fast online bank transfer service linked to all the major banks in Poland. More Details. | |
object (sofort_request) SOFORT Banking is a real-time bank transfer payment method that buyers use to transfer funds directly to merchants from their bank accounts. More Details. | |
object (trustly_request) Trustly is a payment method that allows customers to shop and pay from their bank account. More Details. | |
object (apple_pay_request) ApplePay payment source, allows buyer to pay using ApplePay, both on Web as well as on Native. | |
object (google_pay_request) Google Pay payment source, allows buyer to pay using Google Pay. | |
object (venmo_wallet_request) Information needed to indicate that Venmo is being used to fund the payment. |
{- "card": {
- "name": "string",
- "number": "stringstrings",
- "security_code": "stri",
- "expiry": "string",
- "billing_address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}, - "attributes": {
- "customer": {
- "id": "string",
- "email_address": "string",
- "phone": {
- "phone_type": "FAX",
- "phone_number": {
- "national_number": "string"
}
}, - "merchant_customer_id": "string"
}, - "vault": {
- "store_in_vault": "ON_SUCCESS"
}, - "verification": {
- "method": "SCA_ALWAYS"
}
}, - "stored_credential": {
- "payment_initiator": "CUSTOMER",
- "payment_type": "ONE_TIME",
- "usage": "FIRST",
- "previous_network_transaction_reference": {
- "id": "stringstr",
- "date": "stri",
- "acquirer_reference_number": "string",
- "network": "VISA"
}
}, - "vault_id": "string",
- "single_use_token": "string",
- "network_token": {
- "number": "stringstrings",
- "cryptogram": "stringstringstringstringstri",
- "token_requestor_id": "string",
- "expiry": "string",
- "eci_flag": "MASTERCARD_NON_3D_SECURE_TRANSACTION"
}, - "experience_context": {
- "return_url": "string",
- "cancel_url": "string"
}
}, - "token": {
- "id": "string",
- "type": "BILLING_AGREEMENT"
}, - "paypal": {
- "experience_context": {
- "brand_name": "string",
- "shipping_preference": "GET_FROM_FILE",
- "landing_page": "LOGIN",
- "user_action": "CONTINUE",
- "payment_method_preference": "UNRESTRICTED",
- "locale": "string",
- "return_url": "string",
- "cancel_url": "string"
}, - "billing_agreement_id": "string",
- "vault_id": "string",
- "email_address": "string",
- "name": {
- "given_name": "string",
- "surname": "string"
}, - "phone": {
- "phone_type": "FAX",
- "phone_number": {
- "national_number": "string"
}
}, - "birth_date": "stringstri",
- "tax_info": {
- "tax_id": "string",
- "tax_id_type": "BR_CPF"
}, - "address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}, - "attributes": {
- "customer": {
- "id": "string",
- "email_address": "string",
- "merchant_customer_id": "string"
}, - "vault": {
- "store_in_vault": "ON_SUCCESS",
- "description": "string",
- "usage_pattern": "string",
- "usage_type": "string",
- "customer_type": "CONSUMER",
- "permit_multiple_payment_tokens": false
}
}
}, - "bancontact": {
- "name": "string",
- "country_code": "string",
- "experience_context": {
- "brand_name": "string",
- "shipping_preference": "GET_FROM_FILE",
- "locale": "string",
- "return_url": "string",
- "cancel_url": "string"
}
}, - "blik": {
- "name": "string",
- "country_code": "string",
- "email": "string",
- "experience_context": {
- "brand_name": "string",
- "shipping_preference": "GET_FROM_FILE",
- "locale": "string",
- "return_url": "string",
- "cancel_url": "string",
- "consumer_user_agent": "string",
- "consumer_ip": "string"
}, - "level_0": {
- "auth_code": "string"
}, - "one_click": {
- "auth_code": "string",
- "consumer_reference": "string",
- "alias_label": "stringst",
- "alias_key": "string"
}
}, - "eps": {
- "name": "string",
- "country_code": "string",
- "experience_context": {
- "brand_name": "string",
- "shipping_preference": "GET_FROM_FILE",
- "locale": "string",
- "return_url": "string",
- "cancel_url": "string"
}
}, - "giropay": {
- "name": "string",
- "country_code": "string",
- "experience_context": {
- "brand_name": "string",
- "shipping_preference": "GET_FROM_FILE",
- "locale": "string",
- "return_url": "string",
- "cancel_url": "string"
}
}, - "ideal": {
- "name": "string",
- "country_code": "string",
- "bic": "string",
- "experience_context": {
- "brand_name": "string",
- "shipping_preference": "GET_FROM_FILE",
- "locale": "string",
- "return_url": "string",
- "cancel_url": "string"
}
}, - "mybank": {
- "name": "string",
- "country_code": "string",
- "experience_context": {
- "brand_name": "string",
- "shipping_preference": "GET_FROM_FILE",
- "locale": "string",
- "return_url": "string",
- "cancel_url": "string"
}
}, - "p24": {
- "name": "string",
- "email": "string",
- "country_code": "string",
- "experience_context": {
- "brand_name": "string",
- "shipping_preference": "GET_FROM_FILE",
- "locale": "string",
- "return_url": "string",
- "cancel_url": "string"
}
}, - "sofort": {
- "name": "string",
- "country_code": "string",
- "experience_context": {
- "brand_name": "string",
- "shipping_preference": "GET_FROM_FILE",
- "locale": "string",
- "return_url": "string",
- "cancel_url": "string"
}
}, - "trustly": {
- "name": "string",
- "country_code": "string",
- "experience_context": {
- "brand_name": "string",
- "shipping_preference": "GET_FROM_FILE",
- "locale": "string",
- "return_url": "string",
- "cancel_url": "string"
}
}, - "apple_pay": {
- "id": "string",
- "stored_credential": {
- "payment_initiator": "CUSTOMER",
- "payment_type": "ONE_TIME",
- "usage": "FIRST",
- "previous_network_transaction_reference": {
- "id": "stringstr",
- "date": "stri",
- "acquirer_reference_number": "string",
- "network": "VISA"
}
}, - "attributes": {
- "customer": {
- "id": "string",
- "email_address": "string",
- "phone": {
- "phone_type": "FAX",
- "phone_number": {
- "national_number": "string"
}
}
}, - "vault": {
- "store_in_vault": "ON_SUCCESS"
}
}, - "name": "string",
- "email_address": "string",
- "phone_number": {
- "national_number": "string"
}, - "decrypted_token": {
- "device_manufacturer_id": "string",
- "payment_data_type": "3DSECURE",
- "transaction_amount": {
- "currency_code": "str",
- "value": "string"
}, - "tokenized_card": {
- "name": "string",
- "number": "stringstrings",
- "expiry": "string",
- "card_type": "VISA",
- "type": "CREDIT",
- "brand": "VISA",
- "billing_address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
}, - "payment_data": {
- "cryptogram": "string",
- "eci_indicator": "string",
- "emv_data": "string",
- "pin": "string"
}
}, - "vault_id": "string"
}, - "google_pay": {
- "name": "string",
- "email_address": "string",
- "phone_number": {
- "country_code": "str",
- "national_number": "string"
}, - "card": {
- "name": "string",
- "type": "CREDIT",
- "brand": "VISA",
- "billing_address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
}, - "decrypted_token": {
- "message_id": "string",
- "message_expiration": "stringstrings",
- "payment_method": "CARD",
- "authentication_method": "PAN_ONLY",
- "cryptogram": "string",
- "eci_indicator": "string",
- "card": {
- "name": "string",
- "number": "stringstrings",
- "last_digits": "stri",
- "expiry": "string",
- "type": "CREDIT",
- "brand": "VISA",
- "billing_address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
}
}, - "assurance_details": {
- "account_verified": false,
- "card_holder_authenticated": false
}, - "attributes": {
- "verification": {
- "method": "SCA_ALWAYS"
}
}
}, - "venmo": {
- "experience_context": {
- "brand_name": "string",
- "shipping_preference": "GET_FROM_FILE"
}, - "vault_id": "string",
- "email_address": "string",
- "attributes": {
- "customer": {
- "id": "string",
- "email_address": "string"
}, - "vault": {
- "store_in_vault": "ON_SUCCESS",
- "description": "string",
- "usage_pattern": "string",
- "usage_type": "string",
- "customer_type": "CONSUMER",
- "permit_multiple_payment_tokens": false
}
}
}
}
The payment source definition.
object (card_request) 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. | |
object (token) The tokenized payment source to fund a payment. | |
object (paypal_wallet) Indicates that PayPal Wallet is the payment source. Main use of this selection is to provide additional instructions associated with this choice like vaulting. | |
object (apple_pay_request) ApplePay payment source, allows buyer to pay using ApplePay, both on Web as well as on Native. | |
object (google_pay_request) Google Pay payment source, allows buyer to pay using Google Pay. | |
object (venmo_wallet_request) Information needed to indicate that Venmo is being used to fund the payment. |
{- "card": {
- "name": "string",
- "number": "stringstrings",
- "security_code": "stri",
- "expiry": "string",
- "billing_address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}, - "attributes": {
- "customer": {
- "id": "string",
- "email_address": "string",
- "phone": {
- "phone_type": "FAX",
- "phone_number": {
- "national_number": "string"
}
}, - "merchant_customer_id": "string"
}, - "vault": {
- "store_in_vault": "ON_SUCCESS"
}, - "verification": {
- "method": "SCA_ALWAYS"
}
}, - "stored_credential": {
- "payment_initiator": "CUSTOMER",
- "payment_type": "ONE_TIME",
- "usage": "FIRST",
- "previous_network_transaction_reference": {
- "id": "stringstr",
- "date": "stri",
- "acquirer_reference_number": "string",
- "network": "VISA"
}
}, - "vault_id": "string",
- "single_use_token": "string",
- "network_token": {
- "number": "stringstrings",
- "cryptogram": "stringstringstringstringstri",
- "token_requestor_id": "string",
- "expiry": "string",
- "eci_flag": "MASTERCARD_NON_3D_SECURE_TRANSACTION"
}, - "experience_context": {
- "return_url": "string",
- "cancel_url": "string"
}
}, - "token": {
- "id": "string",
- "type": "BILLING_AGREEMENT"
}, - "paypal": {
- "experience_context": {
- "brand_name": "string",
- "shipping_preference": "GET_FROM_FILE",
- "landing_page": "LOGIN",
- "user_action": "CONTINUE",
- "payment_method_preference": "UNRESTRICTED",
- "locale": "string",
- "return_url": "string",
- "cancel_url": "string"
}, - "billing_agreement_id": "string",
- "vault_id": "string",
- "email_address": "string",
- "name": {
- "given_name": "string",
- "surname": "string"
}, - "phone": {
- "phone_type": "FAX",
- "phone_number": {
- "national_number": "string"
}
}, - "birth_date": "stringstri",
- "tax_info": {
- "tax_id": "string",
- "tax_id_type": "BR_CPF"
}, - "address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}, - "attributes": {
- "customer": {
- "id": "string",
- "email_address": "string",
- "merchant_customer_id": "string"
}, - "vault": {
- "store_in_vault": "ON_SUCCESS",
- "description": "string",
- "usage_pattern": "string",
- "usage_type": "string",
- "customer_type": "CONSUMER",
- "permit_multiple_payment_tokens": false
}
}
}, - "apple_pay": {
- "id": "string",
- "stored_credential": {
- "payment_initiator": "CUSTOMER",
- "payment_type": "ONE_TIME",
- "usage": "FIRST",
- "previous_network_transaction_reference": {
- "id": "stringstr",
- "date": "stri",
- "acquirer_reference_number": "string",
- "network": "VISA"
}
}, - "attributes": {
- "customer": {
- "id": "string",
- "email_address": "string",
- "phone": {
- "phone_type": "FAX",
- "phone_number": {
- "national_number": "string"
}
}
}, - "vault": {
- "store_in_vault": "ON_SUCCESS"
}
}, - "name": "string",
- "email_address": "string",
- "phone_number": {
- "national_number": "string"
}, - "decrypted_token": {
- "device_manufacturer_id": "string",
- "payment_data_type": "3DSECURE",
- "transaction_amount": {
- "currency_code": "str",
- "value": "string"
}, - "tokenized_card": {
- "name": "string",
- "number": "stringstrings",
- "expiry": "string",
- "card_type": "VISA",
- "type": "CREDIT",
- "brand": "VISA",
- "billing_address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
}, - "payment_data": {
- "cryptogram": "string",
- "eci_indicator": "string",
- "emv_data": "string",
- "pin": "string"
}
}, - "vault_id": "string"
}, - "google_pay": {
- "name": "string",
- "email_address": "string",
- "phone_number": {
- "country_code": "str",
- "national_number": "string"
}, - "card": {
- "name": "string",
- "type": "CREDIT",
- "brand": "VISA",
- "billing_address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
}, - "decrypted_token": {
- "message_id": "string",
- "message_expiration": "stringstrings",
- "payment_method": "CARD",
- "authentication_method": "PAN_ONLY",
- "cryptogram": "string",
- "eci_indicator": "string",
- "card": {
- "name": "string",
- "number": "stringstrings",
- "last_digits": "stri",
- "expiry": "string",
- "type": "CREDIT",
- "brand": "VISA",
- "billing_address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
}
}, - "assurance_details": {
- "account_verified": false,
- "card_holder_authenticated": false
}, - "attributes": {
- "verification": {
- "method": "SCA_ALWAYS"
}
}
}, - "venmo": {
- "experience_context": {
- "brand_name": "string",
- "shipping_preference": "GET_FROM_FILE"
}, - "vault_id": "string",
- "email_address": "string",
- "attributes": {
- "customer": {
- "id": "string",
- "email_address": "string"
}, - "vault": {
- "store_in_vault": "ON_SUCCESS",
- "description": "string",
- "usage_pattern": "string",
- "usage_type": "string",
- "customer_type": "CONSUMER",
- "permit_multiple_payment_tokens": false
}
}
}
}
The payment source definition.
object (card_request) 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. | |
object (token) The tokenized payment source to fund a payment. | |
object (paypal_wallet) Indicates that PayPal Wallet is the payment source. Main use of this selection is to provide additional instructions associated with this choice like vaulting. | |
object (apple_pay_request) ApplePay payment source, allows buyer to pay using ApplePay, both on Web as well as on Native. | |
object (google_pay_request) Google Pay payment source, allows buyer to pay using Google Pay. | |
object (venmo_wallet_request) Information needed to indicate that Venmo is being used to fund the payment. |
{- "card": {
- "name": "string",
- "number": "stringstrings",
- "security_code": "stri",
- "expiry": "string",
- "billing_address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}, - "attributes": {
- "customer": {
- "id": "string",
- "email_address": "string",
- "phone": {
- "phone_type": "FAX",
- "phone_number": {
- "national_number": "string"
}
}, - "merchant_customer_id": "string"
}, - "vault": {
- "store_in_vault": "ON_SUCCESS"
}, - "verification": {
- "method": "SCA_ALWAYS"
}
}, - "stored_credential": {
- "payment_initiator": "CUSTOMER",
- "payment_type": "ONE_TIME",
- "usage": "FIRST",
- "previous_network_transaction_reference": {
- "id": "stringstr",
- "date": "stri",
- "acquirer_reference_number": "string",
- "network": "VISA"
}
}, - "vault_id": "string",
- "single_use_token": "string",
- "network_token": {
- "number": "stringstrings",
- "cryptogram": "stringstringstringstringstri",
- "token_requestor_id": "string",
- "expiry": "string",
- "eci_flag": "MASTERCARD_NON_3D_SECURE_TRANSACTION"
}, - "experience_context": {
- "return_url": "string",
- "cancel_url": "string"
}
}, - "token": {
- "id": "string",
- "type": "BILLING_AGREEMENT"
}, - "paypal": {
- "experience_context": {
- "brand_name": "string",
- "shipping_preference": "GET_FROM_FILE",
- "landing_page": "LOGIN",
- "user_action": "CONTINUE",
- "payment_method_preference": "UNRESTRICTED",
- "locale": "string",
- "return_url": "string",
- "cancel_url": "string"
}, - "billing_agreement_id": "string",
- "vault_id": "string",
- "email_address": "string",
- "name": {
- "given_name": "string",
- "surname": "string"
}, - "phone": {
- "phone_type": "FAX",
- "phone_number": {
- "national_number": "string"
}
}, - "birth_date": "stringstri",
- "tax_info": {
- "tax_id": "string",
- "tax_id_type": "BR_CPF"
}, - "address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}, - "attributes": {
- "customer": {
- "id": "string",
- "email_address": "string",
- "merchant_customer_id": "string"
}, - "vault": {
- "store_in_vault": "ON_SUCCESS",
- "description": "string",
- "usage_pattern": "string",
- "usage_type": "string",
- "customer_type": "CONSUMER",
- "permit_multiple_payment_tokens": false
}
}
}, - "apple_pay": {
- "id": "string",
- "stored_credential": {
- "payment_initiator": "CUSTOMER",
- "payment_type": "ONE_TIME",
- "usage": "FIRST",
- "previous_network_transaction_reference": {
- "id": "stringstr",
- "date": "stri",
- "acquirer_reference_number": "string",
- "network": "VISA"
}
}, - "attributes": {
- "customer": {
- "id": "string",
- "email_address": "string",
- "phone": {
- "phone_type": "FAX",
- "phone_number": {
- "national_number": "string"
}
}
}, - "vault": {
- "store_in_vault": "ON_SUCCESS"
}
}, - "name": "string",
- "email_address": "string",
- "phone_number": {
- "national_number": "string"
}, - "decrypted_token": {
- "device_manufacturer_id": "string",
- "payment_data_type": "3DSECURE",
- "transaction_amount": {
- "currency_code": "str",
- "value": "string"
}, - "tokenized_card": {
- "name": "string",
- "number": "stringstrings",
- "expiry": "string",
- "card_type": "VISA",
- "type": "CREDIT",
- "brand": "VISA",
- "billing_address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
}, - "payment_data": {
- "cryptogram": "string",
- "eci_indicator": "string",
- "emv_data": "string",
- "pin": "string"
}
}, - "vault_id": "string"
}, - "google_pay": {
- "name": "string",
- "email_address": "string",
- "phone_number": {
- "country_code": "str",
- "national_number": "string"
}, - "card": {
- "name": "string",
- "type": "CREDIT",
- "brand": "VISA",
- "billing_address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
}, - "decrypted_token": {
- "message_id": "string",
- "message_expiration": "stringstrings",
- "payment_method": "CARD",
- "authentication_method": "PAN_ONLY",
- "cryptogram": "string",
- "eci_indicator": "string",
- "card": {
- "name": "string",
- "number": "stringstrings",
- "last_digits": "stri",
- "expiry": "string",
- "type": "CREDIT",
- "brand": "VISA",
- "billing_address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
}
}, - "assurance_details": {
- "account_verified": false,
- "card_holder_authenticated": false
}, - "attributes": {
- "verification": {
- "method": "SCA_ALWAYS"
}
}
}, - "venmo": {
- "experience_context": {
- "brand_name": "string",
- "shipping_preference": "GET_FROM_FILE"
}, - "vault_id": "string",
- "email_address": "string",
- "attributes": {
- "customer": {
- "id": "string",
- "email_address": "string"
}, - "vault": {
- "store_in_vault": "ON_SUCCESS",
- "description": "string",
- "usage_pattern": "string",
- "usage_type": "string",
- "customer_type": "CONSUMER",
- "permit_multiple_payment_tokens": false
}
}
}
}
The payment source used to fund the payment.
object (card_response) The payment card to use to fund a payment. Card can be a credit or debit card. | |
object (bancontact) Information used to pay Bancontact. | |
object (blik) Information used to pay using BLIK. | |
object (eps) Information used to pay using eps. | |
object (giropay) Information needed to pay using giropay. | |
object (ideal) Information used to pay using iDEAL. | |
object (mybank) Information used to pay using MyBank. | |
object (p24) Information used to pay using P24(Przelewy24). | |
object (sofort) Information used to pay using Sofort. | |
object (trustly) Information needed to pay using Trustly. | |
object (venmo_wallet_response) Venmo wallet response. | |
object (paypal_wallet_response) The PayPal Wallet response. | |
object (apple_pay) Information needed to pay using ApplePay. | |
object (google_pay) Google Pay Wallet payment data. |
{- "card": {
- "name": "string",
- "last_digits": "string",
- "available_networks": [
- "VISA"
], - "from_request": {
- "last_digits": "stri",
- "expiry": "string"
}, - "brand": "VISA",
- "type": "CREDIT",
- "authentication_result": {
- "liability_shift": "NO",
- "three_d_secure": {
- "authentication_status": "Y",
- "enrollment_status": "Y"
}
}, - "attributes": {
- "vault": {
- "id": "string",
- "status": "VAULTED",
- "links": [
- {
- "href": "string",
- "rel": "string",
- "method": "GET"
}
], - "customer": {
- "id": "string",
- "email_address": "string",
- "phone": {
- "phone_type": "FAX",
- "phone_number": {
- "national_number": "string"
}
}, - "merchant_customer_id": "string"
}
}
}, - "expiry": "string",
- "bin_details": {
- "bin": "string",
- "issuing_bank": "string",
- "products": [
- "string"
], - "bin_country_code": "string"
}
}, - "bancontact": {
- "card_last_digits": "stri",
- "name": "string",
- "country_code": "string",
- "bic": "string",
- "iban_last_chars": "string"
}, - "blik": {
- "name": "string",
- "country_code": "string",
- "email": "string",
- "one_click": {
- "consumer_reference": "string"
}
}, - "eps": {
- "name": "string",
- "country_code": "string",
- "bic": "string"
}, - "giropay": {
- "name": "string",
- "country_code": "string",
- "bic": "string"
}, - "ideal": {
- "name": "string",
- "country_code": "string",
- "bic": "string",
- "iban_last_chars": "string"
}, - "mybank": {
- "name": "string",
- "country_code": "string",
- "bic": "string",
- "iban_last_chars": "string"
}, - "p24": {
- "payment_descriptor": "string",
- "method_id": "string",
- "method_description": "string",
- "name": "string",
- "email": "string",
- "country_code": "string"
}, - "sofort": {
- "name": "string",
- "country_code": "string",
- "bic": "string",
- "iban_last_chars": "string"
}, - "trustly": {
- "name": "string",
- "country_code": "string",
- "bic": "string",
- "iban_last_chars": "string"
}, - "venmo": {
- "user_name": "string",
- "attributes": {
- "vault": {
- "id": "string",
- "status": "VAULTED",
- "links": [
- {
- "href": "string",
- "rel": "string",
- "method": "GET"
}
], - "customer": {
- "id": "string"
}
}
}, - "email_address": "string",
- "account_id": "stringstrings",
- "name": {
- "given_name": "string",
- "surname": "string"
}, - "phone_number": {
- "national_number": "string"
}, - "address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
}, - "paypal": {
- "account_status": "VERIFIED",
- "phone_type": "FAX",
- "business_name": "string",
- "attributes": {
- "vault": {
- "id": "string",
- "status": "VAULTED",
- "links": [
- {
- "href": "string",
- "rel": "string",
- "method": "GET"
}
], - "customer": {
- "id": "string",
- "email_address": "string",
- "phone": {
- "phone_type": "FAX",
- "phone_number": {
- "national_number": "string"
}
}, - "merchant_customer_id": "string"
}
}, - "cobranded_cards": [
- {
- "labels": [
- "string"
], - "payee": {
- "email_address": "string",
- "merchant_id": "stringstrings"
}, - "amount": {
- "currency_code": "str",
- "value": "string"
}
}
]
}, - "email_address": "string",
- "account_id": "stringstrings",
- "name": {
- "given_name": "string",
- "surname": "string"
}, - "phone_number": {
- "national_number": "string"
}, - "birth_date": "stringstri",
- "tax_info": {
- "tax_id": "string",
- "tax_id_type": "BR_CPF"
}, - "address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
}, - "apple_pay": {
- "id": "string",
- "token": "string",
- "name": "string",
- "email_address": "string",
- "phone_number": {
- "national_number": "string"
}, - "card": {
- "name": "string",
- "last_digits": "string",
- "available_networks": [
- "VISA"
], - "from_request": {
- "last_digits": "stri",
- "expiry": "string"
}, - "brand": "VISA",
- "type": "CREDIT",
- "authentication_result": {
- "liability_shift": "NO",
- "three_d_secure": {
- "authentication_status": "Y",
- "enrollment_status": "Y"
}
}, - "attributes": {
- "vault": {
- "id": "string",
- "status": "VAULTED",
- "links": [
- {
- "href": "string",
- "rel": "string",
- "method": "GET"
}
], - "customer": {
- "id": "string",
- "email_address": "string",
- "phone": {
- "phone_type": "FAX",
- "phone_number": {
- "national_number": null
}
}, - "merchant_customer_id": "string"
}
}
}, - "expiry": "string",
- "bin_details": {
- "bin": "string",
- "issuing_bank": "string",
- "products": [
- "string"
], - "bin_country_code": "string"
}, - "billing_address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}, - "country_code": "string"
}, - "attributes": {
- "vault": {
- "id": "string",
- "status": "VAULTED",
- "links": [
- {
- "href": "string",
- "rel": "string",
- "method": "GET"
}
], - "customer": {
- "id": "string"
}
}
}
}, - "google_pay": {
- "name": "string",
- "email_address": "string",
- "phone_number": {
- "country_code": "str",
- "national_number": "string"
}, - "card": {
- "name": "string",
- "last_digits": "stri",
- "type": "CREDIT",
- "brand": "VISA",
- "billing_address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}, - "authentication_result": {
- "liability_shift": "NO",
- "three_d_secure": {
- "authentication_status": "Y",
- "enrollment_status": "Y"
}
}
}
}
}
The payment source used to fund the payment.
object (card_response) The payment card to use to fund a payment. Card can be a credit or debit card. | |
object (venmo_wallet_response) Venmo wallet response. | |
object (paypal_wallet_response) The PayPal Wallet response. | |
object (apple_pay) Information needed to pay using ApplePay. | |
object (google_pay) Google Pay Wallet payment data. |
{- "card": {
- "name": "string",
- "last_digits": "string",
- "available_networks": [
- "VISA"
], - "from_request": {
- "last_digits": "stri",
- "expiry": "string"
}, - "brand": "VISA",
- "type": "CREDIT",
- "authentication_result": {
- "liability_shift": "NO",
- "three_d_secure": {
- "authentication_status": "Y",
- "enrollment_status": "Y"
}
}, - "attributes": {
- "vault": {
- "id": "string",
- "status": "VAULTED",
- "links": [
- {
- "href": "string",
- "rel": "string",
- "method": "GET"
}
], - "customer": {
- "id": "string",
- "email_address": "string",
- "phone": {
- "phone_type": "FAX",
- "phone_number": {
- "national_number": "string"
}
}, - "merchant_customer_id": "string"
}
}
}, - "expiry": "string",
- "bin_details": {
- "bin": "string",
- "issuing_bank": "string",
- "products": [
- "string"
], - "bin_country_code": "string"
}
}, - "venmo": {
- "user_name": "string",
- "attributes": {
- "vault": {
- "id": "string",
- "status": "VAULTED",
- "links": [
- {
- "href": "string",
- "rel": "string",
- "method": "GET"
}
], - "customer": {
- "id": "string"
}
}
}, - "email_address": "string",
- "account_id": "stringstrings",
- "name": {
- "given_name": "string",
- "surname": "string"
}, - "phone_number": {
- "national_number": "string"
}, - "address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
}, - "paypal": {
- "account_status": "VERIFIED",
- "phone_type": "FAX",
- "business_name": "string",
- "attributes": {
- "vault": {
- "id": "string",
- "status": "VAULTED",
- "links": [
- {
- "href": "string",
- "rel": "string",
- "method": "GET"
}
], - "customer": {
- "id": "string",
- "email_address": "string",
- "phone": {
- "phone_type": "FAX",
- "phone_number": {
- "national_number": "string"
}
}, - "merchant_customer_id": "string"
}
}, - "cobranded_cards": [
- {
- "labels": [
- "string"
], - "payee": {
- "email_address": "string",
- "merchant_id": "stringstrings"
}, - "amount": {
- "currency_code": "str",
- "value": "string"
}
}
]
}, - "email_address": "string",
- "account_id": "stringstrings",
- "name": {
- "given_name": "string",
- "surname": "string"
}, - "phone_number": {
- "national_number": "string"
}, - "birth_date": "stringstri",
- "tax_info": {
- "tax_id": "string",
- "tax_id_type": "BR_CPF"
}, - "address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
}, - "apple_pay": {
- "id": "string",
- "token": "string",
- "name": "string",
- "email_address": "string",
- "phone_number": {
- "national_number": "string"
}, - "card": {
- "name": "string",
- "last_digits": "string",
- "available_networks": [
- "VISA"
], - "from_request": {
- "last_digits": "stri",
- "expiry": "string"
}, - "brand": "VISA",
- "type": "CREDIT",
- "authentication_result": {
- "liability_shift": "NO",
- "three_d_secure": {
- "authentication_status": "Y",
- "enrollment_status": "Y"
}
}, - "attributes": {
- "vault": {
- "id": "string",
- "status": "VAULTED",
- "links": [
- {
- "href": "string",
- "rel": "string",
- "method": "GET"
}
], - "customer": {
- "id": "string",
- "email_address": "string",
- "phone": {
- "phone_type": "FAX",
- "phone_number": {
- "national_number": null
}
}, - "merchant_customer_id": "string"
}
}
}, - "expiry": "string",
- "bin_details": {
- "bin": "string",
- "issuing_bank": "string",
- "products": [
- "string"
], - "bin_country_code": "string"
}, - "billing_address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}, - "country_code": "string"
}, - "attributes": {
- "vault": {
- "id": "string",
- "status": "VAULTED",
- "links": [
- {
- "href": "string",
- "rel": "string",
- "method": "GET"
}
], - "customer": {
- "id": "string"
}
}
}
}, - "google_pay": {
- "name": "string",
- "email_address": "string",
- "phone_number": {
- "country_code": "str",
- "national_number": "string"
}, - "card": {
- "name": "string",
- "last_digits": "stri",
- "type": "CREDIT",
- "brand": "VISA",
- "billing_address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}, - "authentication_result": {
- "liability_shift": "NO",
- "three_d_secure": {
- "authentication_status": "Y",
- "enrollment_status": "Y"
}
}
}
}
}
The account identifier for a PayPal account.
The account identifier for a PayPal account.
"stringstrings"
A resource that identifies a PayPal Wallet is used for payment.
object (paypal_wallet_experience_context) Customizes the payer experience during the approval process for payment with PayPal. Note: Partners and Marketplaces might configure | |
billing_agreement_id | string (billing_agreement_id) [ 2 .. 128 ] characters ^[a-zA-Z0-9-]+$ The PayPal billing agreement ID. References an approved recurring payment for goods or services. |
vault_id | string (vault_id) [ 1 .. 255 ] characters ^[0-9a-zA-Z_-]+$ The PayPal-generated ID for the payment_source stored within the Vault. |
email_address | string <merchant_common_email_address_v2> (email) [ 3 .. 254 ] characters (?:[a-zA-Z0-9!#$%&'*+/=?^_`{|}~-]+(?:\.[a-zA-... The email address of the PayPal account holder. |
object (Name) The name of the PayPal account holder. Supports only the | |
object (phone_with_type) The phone number of the customer. Available only when you enable the Contact Telephone Number option in the Profile & Settings for the merchant's PayPal account. The | |
birth_date | string <ppaas_date_notime_v2> (date_no_time) = 10 characters ^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|... The birth date of the PayPal account holder in |
object (tax_info) The tax information of the PayPal account holder. Required only for Brazilian PayPal account holder's. Both | |
object (Portable Postal Address (Medium-Grained)) The address of the PayPal account holder. Supports only the | |
object (paypal_wallet_attributes) Additional attributes associated with the use of this wallet. |
{- "experience_context": {
- "brand_name": "string",
- "shipping_preference": "GET_FROM_FILE",
- "landing_page": "LOGIN",
- "user_action": "CONTINUE",
- "payment_method_preference": "UNRESTRICTED",
- "locale": "string",
- "return_url": "string",
- "cancel_url": "string"
}, - "billing_agreement_id": "string",
- "vault_id": "string",
- "email_address": "string",
- "name": {
- "given_name": "string",
- "surname": "string"
}, - "phone": {
- "phone_type": "FAX",
- "phone_number": {
- "national_number": "string"
}
}, - "birth_date": "stringstri",
- "tax_info": {
- "tax_id": "string",
- "tax_id_type": "BR_CPF"
}, - "address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}, - "attributes": {
- "customer": {
- "id": "string",
- "email_address": "string",
- "merchant_customer_id": "string"
}, - "vault": {
- "store_in_vault": "ON_SUCCESS",
- "description": "string",
- "usage_pattern": "string",
- "usage_type": "string",
- "customer_type": "CONSUMER",
- "permit_multiple_payment_tokens": false
}
}
}
Additional attributes associated with the use of this PayPal Wallet.
object (paypal_wallet_customer) The details about a customer in PayPal's system of record. | |
object (vault_paypal_wallet_base) Attributes used to provide the instructions during vaulting of the PayPal Wallet. |
{- "customer": {
- "id": "string",
- "email_address": "string",
- "merchant_customer_id": "string"
}, - "vault": {
- "store_in_vault": "ON_SUCCESS",
- "description": "string",
- "usage_pattern": "string",
- "usage_type": "string",
- "customer_type": "CONSUMER",
- "permit_multiple_payment_tokens": false
}
}
Additional attributes associated with the use of a PayPal Wallet.
object (paypal_wallet_vault_response) The details about a saved PayPal Wallet payment source. | |
Array of objects (cobranded_card) [ 0 .. 25 ] items An array of merchant cobranded cards used by buyer to complete an order. This array will be present if a merchant has onboarded their cobranded card with PayPal and provided corresponding label(s). |
{- "vault": {
- "id": "string",
- "status": "VAULTED",
- "links": [
- {
- "href": "string",
- "rel": "string",
- "method": "GET"
}
], - "customer": {
- "id": "string",
- "email_address": "string",
- "phone": {
- "phone_type": "FAX",
- "phone_number": {
- "national_number": "string"
}
}, - "merchant_customer_id": "string"
}
}, - "cobranded_cards": [
- {
- "labels": [
- "string"
], - "payee": {
- "email_address": "string",
- "merchant_id": "stringstrings"
}, - "amount": {
- "currency_code": "str",
- "value": "string"
}
}
]
}
The details about a customer in PayPal's system of record.
id | string (merchant_partner_customer_id) [ 1 .. 22 ] characters ^[0-9a-zA-Z_-]+$ The unique ID for a customer generated by PayPal. |
email_address | string <merchant_common_email_address_v2> (email) [ 3 .. 254 ] characters (?:[a-zA-Z0-9!#$%&'*+/=?^_`{|}~-]+(?:\.[a-zA-... Email address of the buyer as provided to the merchant or on file with the merchant. Email Address is required if you are processing the transaction using PayPal Guest Processing which is offered to select partners and merchants. For all other use cases we do not expect partners/merchant to send email_address of their customer. |
object (phone_with_type) The phone number of the buyer as provided to the merchant or on file with the merchant. The | |
merchant_customer_id | string [ 1 .. 64 ] characters ^[0-9a-zA-Z-_.^*$@#]+$ Merchants and partners may already have a data-store where their customer information is persisted. Use merchant_customer_id to associate the PayPal-generated customer.id to your representation of a customer. |
{- "id": "string",
- "email_address": "string",
- "phone": {
- "phone_type": "FAX",
- "phone_number": {
- "national_number": "string"
}
}, - "merchant_customer_id": "string"
}
The details about a customer in PayPal's system of record.
id | string (merchant_partner_customer_id) [ 1 .. 22 ] characters ^[0-9a-zA-Z_-]+$ The unique ID for a customer generated by PayPal. |
email_address | string <merchant_common_email_address_v2> (email) [ 3 .. 254 ] characters (?:[a-zA-Z0-9!#$%&'*+/=?^_`{|}~-]+(?:\.[a-zA-... Email address of the buyer as provided to the merchant or on file with the merchant. Email Address is required if you are processing the transaction using PayPal Guest Processing which is offered to select partners and merchants. For all other use cases we do not expect partners/merchant to send email_address of their customer. |
merchant_customer_id | string [ 1 .. 64 ] characters ^[0-9a-zA-Z-_.^*$@#]+$ Merchants and partners may already have a data-store where their customer information is persisted. Use merchant_customer_id to associate the PayPal-generated customer.id to your representation of a customer. |
{- "id": "string",
- "email_address": "string",
- "merchant_customer_id": "string"
}
Customizes the payer experience during the approval process for payment with PayPal.
Note: Partners and Marketplaces might configurebrand_name
andshipping_preference
during partner account setup, which overrides the request values.
brand_name | string [ 1 .. 127 ] characters ^.*$ 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. | ||||||||
shipping_preference | string [ 1 .. 24 ] characters ^[A-Z_]+$ Default: "GET_FROM_FILE" The location from which the shipping address is derived.
| ||||||||
landing_page | string [ 1 .. 13 ] characters ^[0-9A-Z_]+$ Default: "NO_PREFERENCE" The type of landing page to show on the PayPal site for customer checkout.
| ||||||||
user_action | string [ 1 .. 8 ] characters ^[0-9A-Z_]+$ Default: "CONTINUE" Configures a Continue or Pay Now checkout flow.
| ||||||||
payment_method_preference | string [ 1 .. 255 ] characters ^[0-9A-Z_]+$ Default: "UNRESTRICTED" The merchant-preferred payment methods.
| ||||||||
locale | string <ppaas_common_language_v3> (language) [ 2 .. 10 ] characters ^[a-z]{2}(?:-[A-Z][a-z]{3})?(?:-(?:[A-Z]{2}|[... The BCP 47-formatted locale of pages that the PayPal payment experience shows. PayPal supports a five-character code. For example, | ||||||||
return_url | string <uri> (url) The URL where the customer will be redirected upon approving a payment. | ||||||||
cancel_url | string <uri> (url) The URL where the customer will be redirected upon cancelling the payment approval. |
{- "brand_name": "string",
- "shipping_preference": "GET_FROM_FILE",
- "landing_page": "LOGIN",
- "user_action": "CONTINUE",
- "payment_method_preference": "UNRESTRICTED",
- "locale": "string",
- "return_url": "string",
- "cancel_url": "string"
}
The PayPal Wallet response.
account_status | string [ 1 .. 255 ] characters ^[A-Z_]+$ The account status indicates whether the buyer has verified the financial details associated with their PayPal account.
| ||||||
phone_type | string (Phone Type) The phone type. | ||||||
business_name | string [ 0 .. 300 ] characters ^.*$ The business name of the PayPal account holder (populated for business accounts only) | ||||||
object (paypal_wallet_attributes_response) Additional attributes associated with the use of a PayPal Wallet. | |||||||
email_address | string <merchant_common_email_address_v2> (email) [ 3 .. 254 ] characters (?:[a-zA-Z0-9!#$%&'*+/=?^_`{|}~-]+(?:\.[a-zA-... The email address of the PayPal account holder. | ||||||
account_id | string <ppaas_payer_id_v3> (account_id) = 13 characters ^[2-9A-HJ-NP-Z]{13}$ The PayPal-assigned ID for the PayPal account holder. | ||||||
object (Name) The name of the PayPal account holder. Supports only the | |||||||
object (Phone Number) The phone number, in its canonical international E.164 numbering plan format. Available only when you enable the Contact Telephone Number option in the Profile & Settings for the merchant's PayPal account. Supports only the | |||||||
birth_date | string <ppaas_date_notime_v2> (date_no_time) = 10 characters ^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|... The birth date of the PayPal account holder in | ||||||
object (tax_info) The tax information of the PayPal account holder. Required only for Brazilian PayPal account holder's. Both | |||||||
object (Portable Postal Address (Medium-Grained)) The address of the PayPal account holder. Supports only the |
{- "account_status": "VERIFIED",
- "phone_type": "FAX",
- "business_name": "string",
- "attributes": {
- "vault": {
- "id": "string",
- "status": "VAULTED",
- "links": [
- {
- "href": "string",
- "rel": "string",
- "method": "GET"
}
], - "customer": {
- "id": "string",
- "email_address": "string",
- "phone": {
- "phone_type": "FAX",
- "phone_number": {
- "national_number": "string"
}
}, - "merchant_customer_id": "string"
}
}, - "cobranded_cards": [
- {
- "labels": [
- "string"
], - "payee": {
- "email_address": "string",
- "merchant_id": "stringstrings"
}, - "amount": {
- "currency_code": "str",
- "value": "string"
}
}
]
}, - "email_address": "string",
- "account_id": "stringstrings",
- "name": {
- "given_name": "string",
- "surname": "string"
}, - "phone_number": {
- "national_number": "string"
}, - "birth_date": "stringstri",
- "tax_info": {
- "tax_id": "string",
- "tax_id_type": "BR_CPF"
}, - "address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
}
The details about a saved PayPal Wallet payment source.
id | string [ 1 .. 255 ] characters The PayPal-generated ID for the saved payment source. | ||||||||
status | string (Vault Status) [ 1 .. 255 ] characters ^[0-9A-Z_]+$ The vault status.
| ||||||||
Array of objects (Link Description) [ 1 .. 10 ] items An array of request-related HATEOAS links. | |||||||||
object (paypal_wallet_customer) The details about a customer in PayPal's system of record. |
{- "id": "string",
- "status": "VAULTED",
- "links": [
- {
- "href": "string",
- "rel": "string",
- "method": "GET"
}
], - "customer": {
- "id": "string",
- "email_address": "string",
- "phone": {
- "phone_type": "FAX",
- "phone_number": {
- "national_number": "string"
}
}, - "merchant_customer_id": "string"
}
}
The phone number, in its canonical international E.164 numbering plan format.
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). |
{- "national_number": "string"
}
The phone number, in its canonical international E.164 numbering plan format.
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). |
{- "national_number": "string"
}
The phone number in its canonical international E.164 numbering plan format.
country_code | 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). |
{- "country_code": "str",
- "national_number": "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). |
{- "country_code": "str",
- "national_number": "string"
}
The phone number, in its canonical international E.164 numbering plan format.
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). |
{- "national_number": "string"
}
The phone number in its canonical international E.164 numbering plan format.
country_code | 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). |
{- "country_code": "str",
- "national_number": "string"
}
The phone number in its canonical international E.164 numbering plan format.
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). |
{- "national_number": "string"
}
The phone type.
The phone type.
"FAX"
The phone information.
phone_type | string (Phone Type) The phone type. |
required | object (Phone) The phone number, in its canonical international E.164 numbering plan format. Supports only the |
{- "phone_type": "FAX",
- "phone_number": {
- "national_number": "string"
}
}
The platform or partner fee, commission, or brokerage fee that is associated with the transaction. Not a separate or isolated transaction leg from the external perspective. The platform fee is limited in scope and is always associated with the original payment for the purchase unit.
required | object (Money) The fee for this transaction. |
object (payee_base) The recipient of the fee for this transaction. If you omit this value, the default is the API caller. |
{- "amount": {
- "currency_code": "str",
- "value": "string"
}, - "payee": {
- "email_address": "string",
- "merchant_id": "stringstrings"
}
}
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, such as number and street, for example, |
address_line_2 | string <= 300 characters The second line of the address, for example, a suite or apartment number. |
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. This data is formatted 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 2-character ISO 3166-1 code that identifies the country or region. Note: The country code for Great Britain is |
{- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
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, such as number and street, for example, |
address_line_2 | string <= 300 characters The second line of the address, for example, a suite or apartment number. |
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. This data is formatted 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 2-character ISO 3166-1 code that identifies the country or region. Note: The country code for Great Britain is |
{- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
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, such as number and street, for example, |
address_line_2 | string <= 300 characters The second line of the address, for example, a suite or apartment number. |
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. This data is formatted 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 2-character ISO 3166-1 code that identifies the country or region. Note: The country code for Great Britain is |
{- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
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, such as number and street, for example, |
address_line_2 | string <= 300 characters The second line of the address, for example, a suite or apartment number. |
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. This data is formatted 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 2-character ISO 3166-1 code that identifies the country or region. Note: The country code for Great Britain is |
{- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
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, such as number and street, for example, |
address_line_2 | string <= 300 characters The second line of the address, for example, a suite or apartment number. |
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. This data is formatted 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 2-character ISO 3166-1 code that identifies the country or region. Note: The country code for Great Britain is |
{- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
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, such as number and street, for example, |
address_line_2 | string <= 300 characters The second line of the address, for example, a suite or apartment number. |
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. This data is formatted 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 2-character ISO 3166-1 code that identifies the country or region. Note: The country code for Great Britain is |
{- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
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, such as number and street, for example, |
address_line_2 | string <= 300 characters The second line of the address, for example, a suite or apartment number. |
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. This data is formatted 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 2-character ISO 3166-1 code that identifies the country or region. Note: The country code for Great Britain is |
{- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
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, such as number and street, for example, |
address_line_2 | string <= 300 characters The second line of the address, for example, a suite or apartment number. |
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. This data is formatted 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 2-character ISO 3166-1 code that identifies the country or region. Note: The country code for Great Britain is |
{- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
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, such as number and street, for example, |
address_line_2 | string <= 300 characters The second line of the address, for example, a suite or apartment number. |
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. This data is formatted 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 2-character ISO 3166-1 code that identifies the country or region. Note: The country code for Great Britain is |
{- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
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, such as number and street, for example, |
address_line_2 | string <= 300 characters The second line of the address, for example, a suite or apartment number. |
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. This data is formatted 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 2-character ISO 3166-1 code that identifies the country or region. Note: The country code for Great Britain is |
{- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
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, such as number and street, for example, |
address_line_2 | string <= 300 characters The second line of the address, for example, a suite or apartment number. |
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. This data is formatted 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 2-character ISO 3166-1 code that identifies the country or region. Note: The country code for Great Britain is |
{- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
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, such as number and street, for example, |
address_line_2 | string <= 300 characters The second line of the address, for example, a suite or apartment number. |
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. This data is formatted 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 2-character ISO 3166-1 code that identifies the country or region. Note: The country code for Great Britain is |
{- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
The processor response information for payment requests, such as direct credit card transactions.
avs_code | string The address verification code for Visa, Discover, Mastercard, or American Express transactions.
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
cvv_code | string The card verification value code for for Visa, Discover, Mastercard, or American Express.
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
response_code | string Processor response code for the non-PayPal payment processor errors.
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
payment_advice_code | string The declined payment transactions might have payment advice codes. The card networks, like Visa and Mastercard, return payment advice codes.
|
{- "avs_code": "A",
- "cvv_code": "E",
- "response_code": "0000",
- "payment_advice_code": "01"
}
The purchase unit details. Used to capture required information for the payment contract.
reference_id | string [ 1 .. 256 ] characters The API caller-provided external ID for the purchase unit. Required for multiple purchase units when you must update the order through Note: If there are multiple purchase units,
|
description | string [ 1 .. 127 ] characters The purchase description. |
custom_id | string [ 1 .. 255 ] characters The API caller-provided external ID. Used to reconcile API caller-initiated transactions with PayPal transactions. Appears in transaction and settlement reports. |
invoice_id | string [ 1 .. 127 ] characters The API caller-provided external invoice ID for this order. |
id | string [ 1 .. 19 ] characters The PayPal-generated ID for the purchase unit. This ID appears in both the payer's transaction history and the emails that the payer receives. In addition, this ID is available in transaction and settlement reports that merchants and API callers can use to reconcile transactions. This ID is only available when an order is saved by calling |
soft_descriptor | string [ 1 .. 22 ] characters The payment descriptor on account transactions on the customer's credit card statement, that PayPal sends to processors. The maximum length of the soft descriptor information that you can pass in the API field is 22 characters, in the following format:
For unbranded payments (Direct Card) marketplace integrations, use a combination of the seller name and phone number. |
Array of objects (item) An array of items that the customer purchases from the merchant. | |
most_recent_errors | Array of any [ 1 .. 10 ] items The error reason code and description that are the reason for the most recent order decline. |
object (amount_with_breakdown) The total order amount with an optional breakdown that provides details, such as the total item amount, total tax amount, shipping, handling, insurance, and discounts, if any. | |
object (payee) The merchant who receives payment for this transaction. | |
object (payment_instruction) Any additional payment instructions to be consider during payment processing. This processing instruction is applicable for Capturing an order or Authorizing an Order. | |
object (shipping_with_tracking_details) The shipping address and method. | |
object (supplementary_data) Supplementary data about this payment. Merchants and partners can add Level 2 and 3 data to payments to reduce risk and payment processing costs. For more information about processing payments, see checkout or multiparty checkout. | |
object (Payment Collection) The comprehensive history of payments for the purchase unit. |
{- "reference_id": "string",
- "description": "string",
- "custom_id": "string",
- "invoice_id": "string",
- "id": "string",
- "soft_descriptor": "string",
- "items": [
- {
- "name": "string",
- "quantity": "string",
- "description": "string",
- "sku": "string",
- "category": "DIGITAL_GOODS",
- "unit_amount": {
- "currency_code": "str",
- "value": "string"
}, - "tax": {
- "currency_code": "str",
- "value": "string"
}, - "upc": {
- "type": "UPC-A",
- "code": "string"
}
}
], - "most_recent_errors": [
- null
], - "amount": {
- "currency_code": "str",
- "value": "string",
- "breakdown": {
- "item_total": {
- "currency_code": "str",
- "value": "string"
}, - "shipping": {
- "currency_code": "str",
- "value": "string"
}, - "handling": {
- "currency_code": "str",
- "value": "string"
}, - "tax_total": {
- "currency_code": "str",
- "value": "string"
}, - "insurance": {
- "currency_code": "str",
- "value": "string"
}, - "shipping_discount": {
- "currency_code": "str",
- "value": "string"
}, - "discount": {
- "currency_code": "str",
- "value": "string"
}
}
}, - "payee": {
- "email_address": "string",
- "merchant_id": "stringstrings"
}, - "payment_instruction": {
- "platform_fees": [
- {
- "amount": {
- "currency_code": "str",
- "value": "string"
}, - "payee": {
- "email_address": "string",
- "merchant_id": "stringstrings"
}
}
], - "payee_pricing_tier_id": "string",
- "payee_receivable_fx_rate_id": "string",
- "disbursement_mode": "INSTANT"
}, - "shipping": {
- "type": "SHIPPING",
- "options": [
- {
- "id": "string",
- "label": "string",
- "selected": true,
- "type": "SHIPPING",
- "amount": {
- "currency_code": "str",
- "value": "string"
}
}
], - "name": {
- "full_name": "string"
}, - "phone_number": {
- "country_code": "str",
- "national_number": "string"
}, - "address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}, - "trackers": [
- {
- "id": "string",
- "status": "CANCELLED",
- "items": [
- {
- "name": "string",
- "quantity": "string",
- "sku": "string",
- "upc": {
- "type": "UPC-A",
- "code": "string"
}
}
], - "links": [
- {
- "href": "string",
- "rel": "string",
- "method": "GET"
}
], - "create_time": "stringstringstringst",
- "update_time": "stringstringstringst"
}
]
}, - "supplementary_data": {
- "card": {
- "level_2": {
- "invoice_id": "string",
- "tax_total": {
- "currency_code": "str",
- "value": "string"
}
}, - "level_3": {
- "ships_from_postal_code": "string",
- "line_items": [
- {
- "name": "string",
- "quantity": "string",
- "description": "string",
- "sku": "string",
- "upc": {
- "type": "UPC-A",
- "code": "string"
}, - "commodity_code": "string",
- "unit_of_measure": "string",
- "unit_amount": {
- "currency_code": "str",
- "value": "string"
}, - "tax": {
- "currency_code": "str",
- "value": "string"
}, - "discount_amount": {
- "currency_code": "str",
- "value": "string"
}, - "total_amount": {
- "currency_code": "str",
- "value": "string"
}
}
], - "shipping_amount": {
- "currency_code": "str",
- "value": "string"
}, - "duty_amount": {
- "currency_code": "str",
- "value": "string"
}, - "discount_amount": {
- "currency_code": "str",
- "value": "string"
}, - "shipping_address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
}
}
}, - "payments": {
- "authorizations": [
- {
- "status": "CREATED",
- "status_details": {
- "reason": "PENDING_REVIEW"
}, - "id": "string",
- "invoice_id": "string",
- "custom_id": "string",
- "links": [
- {
- "href": "string",
- "rel": "string",
- "method": "GET"
}
], - "amount": {
- "currency_code": "str",
- "value": "string"
}, - "network_transaction_reference": {
- "id": "stringstr",
- "date": "stri",
- "acquirer_reference_number": "string",
- "network": "VISA"
}, - "seller_protection": {
- "status": "ELIGIBLE",
- "dispute_categories": [
- "string"
]
}, - "expiration_time": "string",
- "create_time": "stringstringstringst",
- "update_time": "stringstringstringst",
- "processor_response": {
- "avs_code": "A",
- "cvv_code": "E",
- "response_code": "0000",
- "payment_advice_code": "01"
}
}
], - "captures": [
- {
- "status": "COMPLETED",
- "status_details": {
- "reason": "BUYER_COMPLAINT"
}, - "id": "string",
- "invoice_id": "string",
- "custom_id": "string",
- "final_capture": false,
- "disbursement_mode": "INSTANT",
- "links": [
- {
- "href": "string",
- "rel": "string",
- "method": "GET"
}
], - "amount": {
- "currency_code": "str",
- "value": "string"
}, - "network_transaction_reference": {
- "id": "stringstr",
- "date": "stri",
- "acquirer_reference_number": "string",
- "network": "VISA"
}, - "seller_protection": {
- "status": "ELIGIBLE",
- "dispute_categories": [
- "string"
]
}, - "seller_receivable_breakdown": {
- "platform_fees": [
- {
- "amount": {
- "currency_code": null,
- "value": null
}, - "payee": {
- "email_address": null,
- "merchant_id": null
}
}
], - "gross_amount": {
- "currency_code": "str",
- "value": "string"
}, - "paypal_fee": {
- "currency_code": "str",
- "value": "string"
}, - "paypal_fee_in_receivable_currency": {
- "currency_code": "str",
- "value": "string"
}, - "net_amount": {
- "currency_code": "str",
- "value": "string"
}, - "receivable_amount": {
- "currency_code": "str",
- "value": "string"
}, - "exchange_rate": {
- "value": "string",
- "source_currency": "str",
- "target_currency": "str"
}
}, - "processor_response": {
- "avs_code": "A",
- "cvv_code": "E",
- "response_code": "0000",
- "payment_advice_code": "01"
}, - "create_time": "stringstringstringst",
- "update_time": "stringstringstringst"
}
], - "refunds": [
- {
- "status": "CANCELLED",
- "status_details": {
- "reason": "ECHECK"
}, - "id": "string",
- "invoice_id": "string",
- "custom_id": "string",
- "acquirer_reference_number": "string",
- "note_to_payer": "string",
- "seller_payable_breakdown": {
- "platform_fees": [
- {
- "amount": {
- "currency_code": null,
- "value": null
}, - "payee": {
- "email_address": null,
- "merchant_id": null
}
}
], - "net_amount_breakdown": [
- {
- "payable_amount": {
- "currency_code": null,
- "value": null
}, - "converted_amount": {
- "currency_code": null,
- "value": null
}, - "exchange_rate": {
- "value": null,
- "source_currency": null,
- "target_currency": null
}
}
], - "gross_amount": {
- "currency_code": "str",
- "value": "string"
}, - "paypal_fee": {
- "currency_code": "str",
- "value": "string"
}, - "paypal_fee_in_receivable_currency": {
- "currency_code": "str",
- "value": "string"
}, - "net_amount": {
- "currency_code": "str",
- "value": "string"
}, - "net_amount_in_receivable_currency": {
- "currency_code": "str",
- "value": "string"
}, - "total_refunded_amount": {
- "currency_code": "str",
- "value": "string"
}
}, - "links": [
- {
- "href": "string",
- "rel": "string",
- "method": "GET"
}
], - "amount": {
- "currency_code": "str",
- "value": "string"
}, - "payer": {
- "email_address": "string",
- "merchant_id": "stringstrings"
}, - "create_time": "stringstringstringst",
- "update_time": "stringstringstringst"
}
]
}
}
The purchase unit request. Includes required information for the payment contract.
reference_id | string [ 1 .. 256 ] characters The API caller-provided external ID for the purchase unit. Required for multiple purchase units when you must update the order through |
description | string [ 1 .. 127 ] characters The purchase description. The maximum length of the character is dependent on the type of characters used. The character length is specified assuming a US ASCII character. Depending on type of character; (e.g. accented character, Japanese characters) the number of characters that that can be specified as input might not equal the permissible max length. |
custom_id | string [ 1 .. 255 ] characters The API caller-provided external ID. Used to reconcile client transactions with PayPal transactions. Appears in transaction and settlement reports but is not visible to the payer. |
invoice_id | string [ 1 .. 127 ] characters The API caller-provided external invoice number for this order. Appears in both the payer's transaction history and the emails that the payer receives. |
soft_descriptor | string [ 1 .. 22 ] characters The soft descriptor is the dynamic text used to construct the statement descriptor that appears on a payer's card statement. Note: The merchant descriptor is the descriptor of the merchant’s payment receiving preferences which can be seen by logging into the merchant account https://www.sandbox.paypal.com/businessprofile/settings/info/editThe PAYPAL prefix uses 8 characters. Only the first 22 characters will be displayed in the statement. For example, if:
PAYPAL * Janes Gift 80 .
|
Array of objects (item) An array of items that the customer purchases from the merchant. | |
required | object (amount_with_breakdown) The total order amount with an optional breakdown that provides details, such as the total item amount, total tax amount, shipping, handling, insurance, and discounts, if any. |
object (payee) The merchant who receives payment for this transaction. | |
object (payment_instruction) Any additional payment instructions to be consider during payment processing. This processing instruction is applicable for Capturing an order or Authorizing an Order. | |
object (shipping_detail) The name and address of the person to whom to ship the items. | |
object (supplementary_data) Contains Supplementary Data. |
{- "reference_id": "string",
- "description": "string",
- "custom_id": "string",
- "invoice_id": "string",
- "soft_descriptor": "string",
- "items": [
- {
- "name": "string",
- "quantity": "string",
- "description": "string",
- "sku": "string",
- "category": "DIGITAL_GOODS",
- "unit_amount": {
- "currency_code": "str",
- "value": "string"
}, - "tax": {
- "currency_code": "str",
- "value": "string"
}, - "upc": {
- "type": "UPC-A",
- "code": "string"
}
}
], - "amount": {
- "currency_code": "str",
- "value": "string",
- "breakdown": {
- "item_total": {
- "currency_code": "str",
- "value": "string"
}, - "shipping": {
- "currency_code": "str",
- "value": "string"
}, - "handling": {
- "currency_code": "str",
- "value": "string"
}, - "tax_total": {
- "currency_code": "str",
- "value": "string"
}, - "insurance": {
- "currency_code": "str",
- "value": "string"
}, - "shipping_discount": {
- "currency_code": "str",
- "value": "string"
}, - "discount": {
- "currency_code": "str",
- "value": "string"
}
}
}, - "payee": {
- "email_address": "string",
- "merchant_id": "stringstrings"
}, - "payment_instruction": {
- "platform_fees": [
- {
- "amount": {
- "currency_code": "str",
- "value": "string"
}, - "payee": {
- "email_address": "string",
- "merchant_id": "stringstrings"
}
}
], - "payee_pricing_tier_id": "string",
- "payee_receivable_fx_rate_id": "string",
- "disbursement_mode": "INSTANT"
}, - "shipping": {
- "type": "SHIPPING",
- "options": [
- {
- "id": "string",
- "label": "string",
- "selected": true,
- "type": "SHIPPING",
- "amount": {
- "currency_code": "str",
- "value": "string"
}
}
], - "name": {
- "full_name": "string"
}, - "phone_number": {
- "country_code": "str",
- "national_number": "string"
}, - "address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
}, - "supplementary_data": {
- "card": {
- "level_2": {
- "invoice_id": "string",
- "tax_total": {
- "currency_code": "str",
- "value": "string"
}
}, - "level_3": {
- "ships_from_postal_code": "string",
- "line_items": [
- {
- "name": "string",
- "quantity": "string",
- "description": "string",
- "sku": "string",
- "upc": {
- "type": "UPC-A",
- "code": "string"
}, - "commodity_code": "string",
- "unit_of_measure": "string",
- "unit_amount": {
- "currency_code": "str",
- "value": "string"
}, - "tax": {
- "currency_code": "str",
- "value": "string"
}, - "discount_amount": {
- "currency_code": "str",
- "value": "string"
}, - "total_amount": {
- "currency_code": "str",
- "value": "string"
}
}
], - "shipping_amount": {
- "currency_code": "str",
- "value": "string"
}, - "duty_amount": {
- "currency_code": "str",
- "value": "string"
}, - "discount_amount": {
- "currency_code": "str",
- "value": "string"
}, - "shipping_address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
}
}
}
}
The refund information.
status | string (Refund Status With Details) The status of the refund.
| ||||||||||
object (refund_status_details) The details of the refund status. | |||||||||||
id | string The PayPal-generated ID for the refund. | ||||||||||
invoice_id | string The API caller-provided external invoice number for this order. Appears in both the payer's transaction history and the emails that the payer receives. | ||||||||||
custom_id | string [ 1 .. 255 ] characters ^[A-Za-z0-9-_.,]*$ The API caller-provided external ID. Used to reconcile API caller-initiated transactions with PayPal transactions. Appears in transaction and settlement reports. | ||||||||||
acquirer_reference_number | string [ 1 .. 36 ] characters ^[a-zA-Z0-9]+$ Reference ID issued for the card transaction. This ID can be used to track the transaction across processors, card brands and issuing banks. | ||||||||||
note_to_payer | string The reason for the refund. Appears in both the payer's transaction history and the emails that the payer receives. | ||||||||||
object (Seller Payable Breakdown) The breakdown of the refund. | |||||||||||
Array of objects (Link Description) An array of related HATEOAS links. | |||||||||||
object (Money) The amount that the payee refunded to the payer. | |||||||||||
object (payee_base) The details associated with the merchant for this transaction. | |||||||||||
create_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 date and time when the transaction occurred, in Internet date and time format. | ||||||||||
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 date and time when the transaction was last updated, in Internet date and time format. |
{- "status": "CANCELLED",
- "status_details": {
- "reason": "ECHECK"
}, - "id": "string",
- "invoice_id": "string",
- "custom_id": "string",
- "acquirer_reference_number": "string",
- "note_to_payer": "string",
- "seller_payable_breakdown": {
- "platform_fees": [
- {
- "amount": {
- "currency_code": "str",
- "value": "string"
}, - "payee": {
- "email_address": "string",
- "merchant_id": "stringstrings"
}
}
], - "net_amount_breakdown": [
- {
- "payable_amount": {
- "currency_code": "str",
- "value": "string"
}, - "converted_amount": {
- "currency_code": "str",
- "value": "string"
}, - "exchange_rate": {
- "value": "string",
- "source_currency": "str",
- "target_currency": "str"
}
}
], - "gross_amount": {
- "currency_code": "str",
- "value": "string"
}, - "paypal_fee": {
- "currency_code": "str",
- "value": "string"
}, - "paypal_fee_in_receivable_currency": {
- "currency_code": "str",
- "value": "string"
}, - "net_amount": {
- "currency_code": "str",
- "value": "string"
}, - "net_amount_in_receivable_currency": {
- "currency_code": "str",
- "value": "string"
}, - "total_refunded_amount": {
- "currency_code": "str",
- "value": "string"
}
}, - "links": [
- {
- "href": "string",
- "rel": "string",
- "method": "GET"
}
], - "amount": {
- "currency_code": "str",
- "value": "string"
}, - "payer": {
- "email_address": "string",
- "merchant_id": "stringstrings"
}, - "create_time": "stringstringstringst",
- "update_time": "stringstringstringst"
}
The refund status with details.
status | string (Refund Status With Details) The status of the refund.
| ||||||||||
object (refund_status_details) The details of the refund status. |
{- "status": "CANCELLED",
- "status_details": {
- "reason": "ECHECK"
}
}
The details of the refund status.
reason | string (Refund Incomplete Reason) The reason why the refund has the
|
{- "reason": "ECHECK"
}
The detailed breakdown of the capture activity. This is not available for transactions that are in pending state.
Array of objects (platform_fee) [ 0 .. 1 ] items An array of platform or partner fees, commissions, or brokerage fees that associated with the captured payment. | |
required | object (Money) The amount for this captured payment in the currency of the transaction. |
object (Money) The applicable fee for this captured payment in the currency of the transaction. | |
object (Money) The applicable fee for this captured payment in the receivable currency. Returned only in cases the fee is charged in the receivable currency. Example 'CNY'. | |
object (Money) The net amount that the payee receives for this captured payment in their PayPal account. The net amount is computed as | |
object (Money) The net amount that is credited to the payee's PayPal account. Returned only when the currency of the captured payment is different from the currency of the PayPal account where the payee wants to credit the funds. The amount is computed as | |
object (exchange_rate) The exchange rate that determines the amount that is credited to the payee's PayPal account. Returned when the currency of the captured payment is different from the currency of the PayPal account where the payee wants to credit the funds. |
{- "platform_fees": [
- {
- "amount": {
- "currency_code": "str",
- "value": "string"
}, - "payee": {
- "email_address": "string",
- "merchant_id": "stringstrings"
}
}
], - "gross_amount": {
- "currency_code": "str",
- "value": "string"
}, - "paypal_fee": {
- "currency_code": "str",
- "value": "string"
}, - "paypal_fee_in_receivable_currency": {
- "currency_code": "str",
- "value": "string"
}, - "net_amount": {
- "currency_code": "str",
- "value": "string"
}, - "receivable_amount": {
- "currency_code": "str",
- "value": "string"
}, - "exchange_rate": {
- "value": "string",
- "source_currency": "str",
- "target_currency": "str"
}
}
The level of protection offered as defined by PayPal Seller Protection for Merchants.
status | string (Seller Protection Status) Indicates whether the transaction is eligible for seller protection. For information, see PayPal Seller Protection for Merchants.
| ||||||||
dispute_categories | Array of strings An array of conditions that are covered for the transaction. |
{- "status": "ELIGIBLE",
- "dispute_categories": [
- "string"
]
}
The shipping details.
type | string (Fullfillment Type) [ 1 .. 255 ] characters ^[0-9A-Z_]+$ A classification for the method of purchase fulfillment (e.g shipping, in-store pickup, etc). Either
| ||||||||||
Array of objects (shipping_option) [ 0 .. 10 ] items An array of shipping options that the payee or merchant offers to the payer to ship or pick up their items. | |||||||||||
object (Name) The name of the person to whom to ship the items. Supports only the | |||||||||||
object (Phone) The phone number of the recipient of the shipped items, which may belong to either the payer, or an alternate contact, for delivery. [Format - canonical international E.164 numbering plan] | |||||||||||
object (Portable Postal Address (Medium-Grained)) The address of the person to whom to ship the items. Supports only the |
{- "type": "SHIPPING",
- "options": [
- {
- "id": "string",
- "label": "string",
- "selected": true,
- "type": "SHIPPING",
- "amount": {
- "currency_code": "str",
- "value": "string"
}
}
], - "name": {
- "full_name": "string"
}, - "phone_number": {
- "country_code": "str",
- "national_number": "string"
}, - "address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
}
The shipping details.
type | string (Fullfillment Type) [ 1 .. 255 ] characters ^[0-9A-Z_]+$ A classification for the method of purchase fulfillment (e.g shipping, in-store pickup, etc). Either
| ||||||||||
object (Name) The name of the person to whom to ship the items. Supports only the | |||||||||||
object (Phone) The phone number of the recipient of the shipped items, which may belong to either the payer, or an alternate contact, for delivery. [Format - canonical international E.164 numbering plan] | |||||||||||
object (Portable Postal Address (Medium-Grained)) The address of the person to whom to ship the items. Supports only the |
{- "type": "SHIPPING",
- "name": {
- "full_name": "string"
}, - "phone_number": {
- "country_code": "str",
- "national_number": "string"
}, - "address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
}
The options that the payee or merchant offers to the payer to ship or pick up their items.
id required | string <= 127 characters A unique ID that identifies a payer-selected shipping option. | ||||||||||
label required | string <= 127 characters A description that the payer sees, which helps them choose an appropriate shipping option. For example, | ||||||||||
selected required | boolean If the API request sets | ||||||||||
type | string (shipping_type) A classification for the method of purchase fulfillment.
| ||||||||||
object (Money) The shipping cost for the selected option. |
{- "id": "string",
- "label": "string",
- "selected": true,
- "type": "SHIPPING",
- "amount": {
- "currency_code": "str",
- "value": "string"
}
}
A classification for the method of purchase fulfillment.
A classification for the method of purchase fulfillment.
Enum: | Description |
---|---|
SHIPPING | The payer intends to receive the items at a specified address. |
PICKUP | DEPRECATED. To ensure that seller protection is correctly assigned, please use 'PICKUP_IN_STORE' or 'PICKUP_FROM_PERSON' instead. Currently, this field indicates that the payer intends to pick up the items at a specified address (ie. a store address). |
PICKUP_IN_STORE | The payer intends to pick up the item(s) from the payee's physical store. Also termed as BOPIS, "Buy Online, Pick-up in Store". Seller protection is provided with this option. |
PICKUP_FROM_PERSON | The payer intends to pick up the item(s) from the payee in person. Also termed as BOPIP, "Buy Online, Pick-up in Person". Seller protection is not available, since the payer is receiving the item from the payee in person, and can validate the item prior to payment. |
"SHIPPING"
The order shipping details.
type | string (Fullfillment Type) [ 1 .. 255 ] characters ^[0-9A-Z_]+$ A classification for the method of purchase fulfillment (e.g shipping, in-store pickup, etc). Either
| ||||||||||
Array of objects (shipping_option) [ 0 .. 10 ] items An array of shipping options that the payee or merchant offers to the payer to ship or pick up their items. | |||||||||||
object (Name) The name of the person to whom to ship the items. Supports only the | |||||||||||
object (Phone) The phone number of the recipient of the shipped items, which may belong to either the payer, or an alternate contact, for delivery. [Format - canonical international E.164 numbering plan] | |||||||||||
object (Portable Postal Address (Medium-Grained)) The address of the person to whom to ship the items. Supports only the | |||||||||||
Array of objects (tracker) An array of trackers for a transaction. |
{- "type": "SHIPPING",
- "options": [
- {
- "id": "string",
- "label": "string",
- "selected": true,
- "type": "SHIPPING",
- "amount": {
- "currency_code": "str",
- "value": "string"
}
}
], - "name": {
- "full_name": "string"
}, - "phone_number": {
- "country_code": "str",
- "national_number": "string"
}, - "address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}, - "trackers": [
- {
- "id": "string",
- "status": "CANCELLED",
- "items": [
- {
- "name": "string",
- "quantity": "string",
- "sku": "string",
- "upc": {
- "type": "UPC-A",
- "code": "string"
}
}
], - "links": [
- {
- "href": "string",
- "rel": "string",
- "method": "GET"
}
], - "create_time": "stringstringstringst",
- "update_time": "stringstringstringst"
}
]
}
The PayPal-generated, short-lived, one-time-use token, used to communicate payment information to PayPal for transaction processing.
The PayPal-generated, short-lived, one-time-use token, used to communicate payment information to PayPal for transaction processing.
"string"
Information used to pay using Sofort.
name | string (name) [ 3 .. 300 ] characters The name of the account holder associated with this payment method. |
country_code | string <ppaas_common_country_code_v2> (country_code) = 2 characters ^([A-Z]{2}|C2)$ The two-character ISO 3166-1 country code. |
bic | string (BIC) [ 8 .. 11 ] characters ^[A-Z-a-z0-9]{4}[A-Z-a-z]{2}[A-Z-a-z0-9]{2}([... The bank identification code (BIC). |
iban_last_chars | string (iban_last_chars) [ 4 .. 34 ] characters [a-zA-Z0-9]{4} The last characters of the IBAN used to pay. |
{- "name": "string",
- "country_code": "string",
- "bic": "string",
- "iban_last_chars": "string"
}
Information needed to pay using Sofort.
name required | string (name) [ 3 .. 300 ] characters The name of the account holder associated with this payment method. |
country_code required | string <ppaas_common_country_code_v2> (country_code) = 2 characters ^([A-Z]{2}|C2)$ The two-character ISO 3166-1 country code. |
object (experience_context_base) Customizes the payer experience during the approval process for the payment. |
{- "name": "string",
- "country_code": "string",
- "experience_context": {
- "brand_name": "string",
- "shipping_preference": "GET_FROM_FILE",
- "locale": "string",
- "return_url": "string",
- "cancel_url": "string"
}
}
Defines how and when the payment source gets vaulted.
Defines how and when the payment source gets vaulted.
Value: | Description |
---|---|
ON_SUCCESS | Defines that the payment_source will be vaulted only when at least one authorization or capture using that payment_source is successful. |
"ON_SUCCESS"
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
.previous_transaction_reference
and previous_network_transaction_reference
- can be present in the request.payment_initiator required | string (payment_initiator) [ 1 .. 255 ] characters ^[0-9A-Z_]+$ The person or party who initiated or triggered the payment.
| ||||||||
payment_type required | string (stored_payment_source_payment_type) [ 1 .. 255 ] characters ^[0-9A-Z_]+$ Indicates the type of the stored payment_source payment.
| ||||||||
usage | string (stored_payment_source_usage_type) [ 1 .. 255 ] characters ^[0-9A-Z_]+$ Default: "DERIVED" Indicates if this is a
| ||||||||
object (network_transaction_reference) Reference values used by the card network to identify a transaction. |
{- "payment_initiator": "CUSTOMER",
- "payment_type": "ONE_TIME",
- "usage": "FIRST",
- "previous_network_transaction_reference": {
- "id": "stringstr",
- "date": "stri",
- "acquirer_reference_number": "string",
- "network": "VISA"
}
}
Indicates the type of the stored payment_source payment.
Indicates the type of the stored payment_source payment.
Enum: | Description |
---|---|
ONE_TIME | One Time payment such as online purchase or donation. (e.g. Checkout with one-click). |
RECURRING | Payment which is part of a series of payments with fixed or variable amounts, following a fixed time interval. (e.g. Subscription payments). |
UNSCHEDULED | Payment which is part of a series of payments that occur on a non-fixed schedule and/or have variable amounts. (e.g. Account Topup payments). |
"ONE_TIME"
Indicates if this is a first
or subsequent
payment using a stored payment source (also referred to as stored credential or card on file).
Indicates if this is a first
or subsequent
payment using a stored payment source (also referred to as stored credential or card on file).
Enum: | Description |
---|---|
FIRST | Indicates the Initial/First payment with a payment_source that is intended to be stored upon successful processing of the payment. |
SUBSEQUENT | Indicates a payment using a stored payment_source which has been successfully used previously for a payment. |
DERIVED | Indicates that PayPal will derive the value of |
"FIRST"
Supplementary data about a payment. This object passes information that can be used to improve risk assessments and processing costs, for example, by providing Level 2 and Level 3 payment data.
object (card_supplementary_data) Merchants and partners can add Level 2 and 3 data to payments to reduce risk and payment processing costs. For more information about processing payments, see checkout or multiparty checkout. |
{- "card": {
- "level_2": {
- "invoice_id": "string",
- "tax_total": {
- "currency_code": "str",
- "value": "string"
}
}, - "level_3": {
- "ships_from_postal_code": "string",
- "line_items": [
- {
- "name": "string",
- "quantity": "string",
- "description": "string",
- "sku": "string",
- "upc": {
- "type": "UPC-A",
- "code": "string"
}, - "commodity_code": "string",
- "unit_of_measure": "string",
- "unit_amount": {
- "currency_code": "str",
- "value": "string"
}, - "tax": {
- "currency_code": "str",
- "value": "string"
}, - "discount_amount": {
- "currency_code": "str",
- "value": "string"
}, - "total_amount": {
- "currency_code": "str",
- "value": "string"
}
}
], - "shipping_amount": {
- "currency_code": "str",
- "value": "string"
}, - "duty_amount": {
- "currency_code": "str",
- "value": "string"
}, - "discount_amount": {
- "currency_code": "str",
- "value": "string"
}, - "shipping_address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
}
}
}
The tax ID of the customer. The customer is also known as the payer. Both tax_id
and tax_id_type
are required.
tax_id required | string [ 1 .. 14 ] characters ([a-zA-Z0-9]) The customer's tax ID value. | ||||||
tax_id_type required | string [ 1 .. 14 ] characters ^[A-Z0-9_]+$ The customer's tax ID type.
|
{- "tax_id": "string",
- "tax_id_type": "BR_CPF"
}
Results of 3D Secure Authentication.
authentication_status | string (pares_status) [ 1 .. 255 ] characters ^[0-9A-Z_]+$ The outcome of the issuer's authentication.
| ||||||||||||||||||
enrollment_status | string (enrolled) [ 1 .. 255 ] characters ^[0-9A-Z_]+$ Status of authentication eligibility.
|
{- "authentication_status": "Y",
- "enrollment_status": "Y"
}
The tokenized payment source to fund a payment.
id required | string [ 1 .. 255 ] characters ^[0-9a-zA-Z_-]+$ The PayPal-generated ID for the token. | ||||
type required | string [ 1 .. 255 ] characters ^[0-9A-Z_-]+$ The tokenization method that generated the ID.
|
{- "id": "string",
- "type": "BILLING_AGREEMENT"
}
The tracking response on creation of tracker.
id | string The tracker id. | ||||||
status | string (Tracker Status) [ 1 .. 64 ] characters ^[0-9A-Z_]+$ The status of the item shipment.
| ||||||
Array of objects (tracker_item) An array of details of items in the shipment. | |||||||
Array of objects (Link Description) An array of request-related HATEOAS links. | |||||||
create_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 date and time when the transaction occurred, in Internet date and time format. | ||||||
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 date and time when the transaction was last updated, in Internet date and time format. |
{- "id": "string",
- "status": "CANCELLED",
- "items": [
- {
- "name": "string",
- "quantity": "string",
- "sku": "string",
- "upc": {
- "type": "UPC-A",
- "code": "string"
}
}
], - "links": [
- {
- "href": "string",
- "rel": "string",
- "method": "GET"
}
], - "create_time": "stringstringstringst",
- "update_time": "stringstringstringst"
}
The tracking information for a shipment.
tracking_number required | string [ 1 .. 64 ] characters The tracking number for the shipment. This property supports Unicode. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
carrier_name_other | string [ 1 .. 64 ] characters The name of the carrier for the shipment. Provide this value only if the carrier parameter is OTHER. This property supports Unicode. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
carrier required | string (carrier) [ 1 .. 64 ] characters ^[0-9A-Z_]+$ The carrier for the shipment. Some carriers have a global version as well as local subsidiaries. The subsidiaries are repeated over many countries and might also have an entry in the global list. Choose the carrier for your country. If the carrier is not available for your country, choose the global version of the carrier. If your carrier name is not in the list, set
|
{- "tracking_number": "string",
- "carrier_name_other": "string",
- "carrier": "DPD_RU"
}
The status of the item shipment.
The status of the item shipment.
Enum: | Description |
---|---|
CANCELLED | The shipment was cancelled and the tracking number no longer applies. |
SHIPPED | The merchant has assigned a tracking number to the items being shipped from the Order. This does not correspond to the carrier's actual status for the shipment. The latest status of the parcel must be retrieved from the carrier. |
"CANCELLED"
The details of the items in the shipment.
name | string [ 1 .. 127 ] characters The item name or title. |
quantity | string [ 1 .. 10 ] characters ^[1-9][0-9]{0,9}$ The item quantity. Must be a whole number. |
sku | string [ 1 .. 127 ] characters The stock keeping unit (SKU) for the item. This can contain unicode characters. |
url | string <uri> [ 1 .. 2048 ] characters The URL to the item being purchased. Visible to buyer and used in buyer experiences. |
image_url | string <uri> [ 1 .. 2048 ] characters ^(https:)([/|.|\w|\s|-])*\.(?:jpg|gif|png|jpe... The URL of the item's image. File type and size restrictions apply. An image that violates these restrictions will not be honored. |
object (universal_product_code) The Universal Product Code of the item. |
{- "name": "string",
- "quantity": "string",
- "sku": "string",
- "upc": {
- "type": "UPC-A",
- "code": "string"
}
}
The tracking details of an order.
tracking_number required | string [ 1 .. 64 ] characters The tracking number for the shipment. This property supports Unicode. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
carrier_name_other | string [ 1 .. 64 ] characters The name of the carrier for the shipment. Provide this value only if the carrier parameter is OTHER. This property supports Unicode. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
carrier required | string (carrier) [ 1 .. 64 ] characters ^[0-9A-Z_]+$ The carrier for the shipment. Some carriers have a global version as well as local subsidiaries. The subsidiaries are repeated over many countries and might also have an entry in the global list. Choose the carrier for your country. If the carrier is not available for your country, choose the global version of the carrier. If your carrier name is not in the list, set
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
capture_id required | string [ 1 .. 50 ] characters ^[a-zA-Z0-9]*$ The PayPal capture ID. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
notify_payer | boolean Default: false If true, sends an email notification to the payer of the PayPal transaction. The email contains the tracking information that was uploaded through the API. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Array of objects (tracker_item) An array of details of items in the shipment. |
{- "tracking_number": "string",
- "carrier_name_other": "string",
- "carrier": "DPD_RU",
- "capture_id": "string",
- "notify_payer": false,
- "items": [
- {
- "name": "string",
- "quantity": "string",
- "sku": "string",
- "upc": {
- "type": "UPC-A",
- "code": "string"
}
}
]
}
The tracking number type.
The tracking number type.
Enum: | Description |
---|---|
CARRIER_PROVIDED | A carrier-provided tracking number. |
E2E_PARTNER_PROVIDED | A marketplace-provided tracking number. |
"CARRIER_PROVIDED"
The status of the item shipment. For allowed values, see Shipping Statuses.
The status of the item shipment. For allowed values, see Shipping Statuses.
Enum: | Description |
---|---|
CANCELLED | The shipment was cancelled and the tracking number no longer applies. |
DELIVERED | The item was already delivered when the tracking number was uploaded. |
LOCAL_PICKUP | Either the buyer physically picked up the item or the seller delivered the item in person without involving any couriers or postal companies. |
ON_HOLD | The item is on hold. Its shipment was temporarily stopped due to bad weather, a strike, customs, or another reason. |
SHIPPED | The item was shipped and is on the way. |
"CANCELLED"
Information needed to pay using Trustly.
name | string (name) [ 3 .. 300 ] characters The name of the account holder associated with this payment method. |
country_code | string <ppaas_common_country_code_v2> (country_code) = 2 characters ^([A-Z]{2}|C2)$ The two-character ISO 3166-1 country code. |
bic | string (BIC) [ 8 .. 11 ] characters ^[A-Z-a-z0-9]{4}[A-Z-a-z]{2}[A-Z-a-z0-9]{2}([... The bank identification code (BIC). |
iban_last_chars | string (iban_last_chars) [ 4 .. 34 ] characters [a-zA-Z0-9]{4} The last characters of the IBAN used to pay. |
{- "name": "string",
- "country_code": "string",
- "bic": "string",
- "iban_last_chars": "string"
}
Information needed to pay using Trustly.
name required | string (name) [ 3 .. 300 ] characters The name of the account holder associated with this payment method. |
country_code required | string <ppaas_common_country_code_v2> (country_code) = 2 characters ^([A-Z]{2}|C2)$ The two-character ISO 3166-1 country code. |
object (experience_context_base) Customizes the payer experience during the approval process for the payment. |
{- "name": "string",
- "country_code": "string",
- "experience_context": {
- "brand_name": "string",
- "shipping_preference": "GET_FROM_FILE",
- "locale": "string",
- "return_url": "string",
- "cancel_url": "string"
}
}
The Universal Product Code of the item.
type required | string (Universal Product Code Type) [ 1 .. 5 ] characters ^[0-9A-Z_-]+$ The Universal Product Code type.
| ||||||||||||||||
code required | string [ 6 .. 17 ] characters ^[0-9]{0,17}$ The UPC product code of the item. |
{- "type": "UPC-A",
- "code": "string"
}
Describes the URL.
Describes the URL.
Base vaulting specification. The object can be extended for specific use cases within each payment_source that supports vaulting.
store_in_vault required | string (store_in_vault_instruction) [ 1 .. 255 ] characters ^[0-9A-Z_]+$ Defines how and when the payment source gets vaulted.
|
{- "store_in_vault": "ON_SUCCESS"
}
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.
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.
"string"
Basic vault instruction specification that can be extended by specific payment sources that supports vaulting.
store_in_vault | string (store_in_vault_instruction) [ 1 .. 255 ] characters ^[0-9A-Z_]+$ Defines how and when the payment source gets vaulted.
|
{- "store_in_vault": "ON_SUCCESS"
}
Resource consolidating common request and response attributes for vaulting PayPal Wallet.
store_in_vault | string (store_in_vault_instruction) [ 1 .. 255 ] characters ^[0-9A-Z_]+$ Defines how and when the payment source gets vaulted.
| ||||
description | string [ 1 .. 128 ] characters The description displayed to PayPal consumer on the approval flow for PayPal, as well as on the PayPal payment token management experience on PayPal.com. | ||||
usage_pattern | string (PayPal Payment Token Usage Pattern) [ 1 .. 30 ] characters Expected business/pricing model for the billing agreement. | ||||
usage_type required | string (PayPal Payment Token Usage Type) [ 1 .. 255 ] characters ^[0-9A-Z_]+$ The usage type associated with the PayPal payment token. | ||||
customer_type | string (PayPal Payment Token Customer Type) [ 1 .. 255 ] characters ^[0-9A-Z_]+$ Default: "CONSUMER" The customer type associated with the PayPal payment token. This is to indicate whether the customer acting on the merchant / platform is either a business or a consumer. | ||||
permit_multiple_payment_tokens | boolean Default: false Create multiple payment tokens for the same payer, merchant/platform combination. Use this when the customer has not logged in at merchant/platform. The payment token thus generated, can then also be used to create the customer account at merchant/platform. Use this also when multiple payment tokens are required for the same payer, different customer at merchant/platform. This helps to identify customers distinctly even though they may share the same PayPal account. This only applies to PayPal payment source. |
{- "store_in_vault": "ON_SUCCESS",
- "description": "string",
- "usage_pattern": "string",
- "usage_type": "string",
- "customer_type": "CONSUMER",
- "permit_multiple_payment_tokens": false
}
The details about a saved payment source.
id | string [ 1 .. 255 ] characters The PayPal-generated ID for the saved payment source. | ||||||||
status | string (Vault Status) [ 1 .. 255 ] characters ^[0-9A-Z_]+$ The vault status.
| ||||||||
Array of objects (Link Description) [ 1 .. 10 ] items An array of request-related HATEOAS links. |
{- "id": "string",
- "status": "VAULTED",
- "links": [
- {
- "href": "string",
- "rel": "string",
- "method": "GET"
}
]
}
The details about a saved payment source.
id | string [ 1 .. 255 ] characters The PayPal-generated ID for the saved payment source. | ||||||||
status | string (Vault Status) [ 1 .. 255 ] characters ^[0-9A-Z_]+$ The vault status.
| ||||||||
Array of objects (Link Description) [ 1 .. 10 ] items An array of request-related HATEOAS links. |
{- "id": "string",
- "status": "VAULTED",
- "links": [
- {
- "href": "string",
- "rel": "string",
- "method": "GET"
}
]
}
The details about a saved payment source.
id | string [ 1 .. 255 ] characters The PayPal-generated ID for the saved payment source. | ||||||||
status | string (Vault Status) [ 1 .. 255 ] characters ^[0-9A-Z_]+$ The vault status.
| ||||||||
Array of objects (Link Description) [ 1 .. 10 ] items An array of request-related HATEOAS links. | |||||||||
object (customer) The details about a customer in PayPal's system of record. |
{- "id": "string",
- "status": "VAULTED",
- "links": [
- {
- "href": "string",
- "rel": "string",
- "method": "GET"
}
], - "customer": {
- "id": "string"
}
}
Resource consolidating common request and response attirbutes for vaulting Venmo Wallet.
store_in_vault required | string (store_in_vault_instruction) [ 1 .. 255 ] characters ^[0-9A-Z_]+$ Defines how and when the payment source gets vaulted.
| ||||
description | string [ 1 .. 128 ] characters ^[a-zA-Z0-9_'\-., :;\!?"]*$ The description displayed to Venmo consumer on the approval flow for Venmo, as well as on the Venmo payment token management experience on Venmo.com. | ||||
usage_pattern | string (Venmo Payment Token Usage Pattern) [ 1 .. 30 ] characters ^[0-9A-Z_]+$ Expected business/pricing model for the billing agreement. | ||||
usage_type required | string (Venmo Payment Token Usage Type) [ 1 .. 255 ] characters ^[0-9A-Z_]+$ The usage type associated with the Venmo payment token. | ||||
customer_type | string (Venmo Payment Token Customer Type) [ 1 .. 255 ] characters ^[0-9A-Z_]+$ Default: "CONSUMER" The customer type associated with the Venmo payment token. This is to indicate whether the customer acting on the merchant / platform is either a business or a consumer. | ||||
permit_multiple_payment_tokens | boolean Default: false Create multiple payment tokens for the same payer, merchant/platform combination. Use this when the customer has not logged in at merchant/platform. The payment token thus generated, can then also be used to create the customer account at merchant/platform. Use this also when multiple payment tokens are required for the same payer, different customer at merchant/platform. This helps to identify customers distinctly even though they may share the same Venmo account. |
{- "store_in_vault": "ON_SUCCESS",
- "description": "string",
- "usage_pattern": "string",
- "usage_type": "string",
- "customer_type": "CONSUMER",
- "permit_multiple_payment_tokens": false
}
Additional attributes associated with the use of this Venmo Wallet.
object (customer) The details about a customer in PayPal's system of record. | |
object (vault_Venmo_wallet_base) Attributes used to provide the instructions during vaulting of the Venmo Wallet. |
{- "customer": {
- "id": "string",
- "email_address": "string"
}, - "vault": {
- "store_in_vault": "ON_SUCCESS",
- "description": "string",
- "usage_pattern": "string",
- "usage_type": "string",
- "customer_type": "CONSUMER",
- "permit_multiple_payment_tokens": false
}
}
Additional attributes associated with the use of a Venmo Wallet.
object (vault_response) The details about a saved payment source. |
{- "vault": {
- "id": "string",
- "status": "VAULTED",
- "links": [
- {
- "href": "string",
- "rel": "string",
- "method": "GET"
}
], - "customer": {
- "id": "string"
}
}
}
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.
brand_name | string [ 1 .. 127 ] characters ^.*$ The business name of the merchant. The pattern is defined by an external party and supports Unicode. | ||||||||
shipping_preference | string [ 1 .. 24 ] characters ^[A-Z_]+$ Default: "GET_FROM_FILE" The location from which the shipping address is derived.
|
{- "brand_name": "string",
- "shipping_preference": "GET_FROM_FILE"
}
Information needed to pay using Venmo.
object (venmo_wallet_experience_context) Customizes the buyer experience during the approval process for payment with Venmo. Note: Partners and Marketplaces might configure
| |
vault_id | string (vault_id) [ 1 .. 255 ] characters ^[0-9a-zA-Z_-]+$ The PayPal-generated ID for the saved Venmo wallet payment_source. This ID should be stored on the merchant's server so the saved payment source can be used for future transactions. |
email_address | string <merchant_common_email_address_v2> (email) [ 3 .. 254 ] characters (?:[a-zA-Z0-9!#$%&'*+/=?^_`{|}~-]+(?:\.[a-zA-... The email address of the payer. |
object (venmo_wallet_attributes) Additional attributes associated with the use of this wallet. |
{- "experience_context": {
- "brand_name": "string",
- "shipping_preference": "GET_FROM_FILE"
}, - "vault_id": "string",
- "email_address": "string",
- "attributes": {
- "customer": {
- "id": "string",
- "email_address": "string"
}, - "vault": {
- "store_in_vault": "ON_SUCCESS",
- "description": "string",
- "usage_pattern": "string",
- "usage_type": "string",
- "customer_type": "CONSUMER",
- "permit_multiple_payment_tokens": false
}
}
}
Venmo wallet response.
user_name | string [ 1 .. 50 ] characters ^[-a-zA-Z0-9_]*$ The Venmo user name chosen by the user, also know as a Venmo handle. |
object (venmo_wallet_attributes_response) Additional attributes associated with the use of a Venmo Wallet. | |
email_address | string <merchant_common_email_address_v2> (email) [ 3 .. 254 ] characters (?:[a-zA-Z0-9!#$%&'*+/=?^_`{|}~-]+(?:\.[a-zA-... The email address of the payer. |
account_id | string <ppaas_payer_id_v3> (account_id) = 13 characters ^[2-9A-HJ-NP-Z]{13}$ This is an immutable system-generated id for a user's Venmo account. |
object (Name) The name associated with the Venmo account. Supports only the | |
object (Phone Number) The phone number associated with the Venmo account, in its canonical international E.164 numbering plan format. Supports only the | |
object (Portable Postal Address (Medium-Grained)) The address of the payer. Supports only the |
{- "user_name": "string",
- "attributes": {
- "vault": {
- "id": "string",
- "status": "VAULTED",
- "links": [
- {
- "href": "string",
- "rel": "string",
- "method": "GET"
}
], - "customer": {
- "id": "string"
}
}
}, - "email_address": "string",
- "account_id": "stringstrings",
- "name": {
- "given_name": "string",
- "surname": "string"
}, - "phone_number": {
- "national_number": "string"
}, - "address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "admin_area_2": "string",
- "admin_area_1": "string",
- "postal_code": "string",
- "country_code": "st"
}
}