{ "openapi": "3.0.3", "info": { "title": "Orders", "description": "An order represents a payment between two or more parties. Use the Orders API to create, update, retrieve, authorize, and capture orders.", "version": "2.25", "contact": {} }, "servers": [ { "url": "https://api-m.sandbox.paypal.com", "description": "PayPal Sandbox Environment" }, { "url": "https://api-m.paypal.com", "description": "PayPal Live Environment" } ], "tags": [ { "name": "orders", "description": "Use the `/orders` resource to create, update, retrieve, authorize, capture and track orders." }, { "name": "trackers", "description": "Use the `/trackers` resource to update and retrieve tracking information for PayPal orders." }, { "name": "externalcallback", "description": "PayPal will use the callback url defined in the create order request to send merchants shipping address and shipping options data while the buyer is in the PayPal checkout." } ], "externalDocs": { "url": "https://developer.paypal.com/docs/api/orders/v2/" }, "paths": { "/v2/checkout/orders": { "post": { "summary": "Create order", "description": "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.
", "operationId": "orders.create", "responses": { "200": { "description": "A successful response to an idempotent request returns the HTTP `200 OK` status code with a JSON response body that shows order details.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/order" } } } }, "201": { "description": "A successful request returns the HTTP `201 Created` status code and a JSON response body that includes by default a minimal response with the ID, status, and HATEOAS links. If you require the complete order resource representation, you must pass the Prefer: return=representation request header. This header value is not the default.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/order" }, "examples": { "orders_request_create": { "value": { "intent": "CAPTURE", "purchase_units": [ { "reference_id": "d9f80740-38f0-11e8-b467-0ed5f89f718b", "amount": { "currency_code": "USD", "value": "100.00" } } ] } } } } } }, "400": { "description": "Request is not well-formed, syntactically incorrect, or violates schema.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/error_400" }, { "$ref": "#/components/schemas/400" } ] } } } }, "401": { "description": "Authentication failed due to missing authorization header, or invalid authentication credentials.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/error_401" }, { "$ref": "#/components/schemas/401" } ] } } } }, "422": { "description": "The requested action could not be performed, semantically incorrect, or failed business validation.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/error_422" }, { "$ref": "#/components/schemas/422" } ] } } } }, "default": { "$ref": "#/components/responses/default" } }, "parameters": [ { "$ref": "#/components/parameters/paypal_request_id" }, { "$ref": "#/components/parameters/paypal_partner_attribution_id" }, { "$ref": "#/components/parameters/paypal_client_metadata_id" }, { "$ref": "#/components/parameters/prefer" }, { "$ref": "#/components/parameters/paypal_auth_assertion" } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/order_request" }, "examples": { "order_request": { "value": { "intent": "CAPTURE", "purchase_units": [ { "reference_id": "d9f80740-38f0-11e8-b467-0ed5f89f718b", "amount": { "currency_code": "USD", "value": "100.00" } } ], "payment_source": { "paypal": { "experience_context": { "payment_method_preference": "IMMEDIATE_PAYMENT_REQUIRED", "payment_method_selected": "PAYPAL", "brand_name": "EXAMPLE INC", "locale": "en-US", "landing_page": "LOGIN", "user_action": "PAY_NOW", "return_url": "https://example.com/returnUrl", "cancel_url": "https://example.com/cancelUrl" } } } } } } } }, "required": true }, "security": [ { "Oauth2": [ "https://uri.paypal.com/services/payments/payment", "https://uri.paypal.com/services/payments/orders/deprecating-jssdk-migration-for-limited-merchants" ] } ], "tags": ["orders"] } }, "/v2/checkout/orders/{id}": { "get": { "summary": "Show order details", "description": "Shows details for an order, by ID.
Note: For error handling and troubleshooting, see Orders v2 errors.
", "operationId": "orders.get", "responses": { "200": { "description": "A successful request returns the HTTP `200 OK` status code and a JSON response body that shows order details.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/order" } } } }, "401": { "description": "Authentication failed due to missing authorization header, or invalid authentication credentials.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/error_401" }, { "$ref": "#/components/schemas/401" } ] } } } }, "404": { "description": "The specified resource does not exist.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/error_404" }, { "$ref": "#/components/schemas/404" } ] } } } }, "default": { "$ref": "#/components/responses/default" } }, "parameters": [ { "$ref": "#/components/parameters/id" }, { "$ref": "#/components/parameters/paypal_auth_assertion" }, { "$ref": "#/components/parameters/fields" } ], "security": [ { "Oauth2": [ "https://uri.paypal.com/services/payments/payment", "https://uri.paypal.com/services/payments/orders/deprecating-jssdk-migration-for-limited-merchants" ] } ], "tags": ["orders"] }, "patch": { "summary": "Update order", "description": "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:

AttributeOpNotes
intentreplace
payerreplace, addUsing replace op for payer will replace the whole payer object with the value sent in request.
purchase_unitsreplace, add
purchase_units[].custom_idreplace, add, remove
purchase_units[].descriptionreplace, add, remove
purchase_units[].payee.emailreplace
purchase_units[].shipping.namereplace, add
purchase_units[].shipping.email_addressreplace, add
purchase_units[].shipping.phone_numberreplace, add
purchase_units[].shipping.optionsreplace, add
purchase_units[].shipping.addressreplace, add
purchase_units[].shipping.typereplace, add
purchase_units[].soft_descriptorreplace, remove
purchase_units[].amountreplace
purchase_units[].itemsreplace, add, remove
purchase_units[].invoice_idreplace, add, remove
purchase_units[].payment_instructionreplace
purchase_units[].payment_instruction.disbursement_modereplaceBy default, disbursement_mode is INSTANT.
purchase_units[].payment_instruction.payee_receivable_fx_rate_idreplace, add, remove
purchase_units[].payment_instruction.platform_feesreplace, add, remove
purchase_units[].supplementary_data.airlinereplace, add, remove
purchase_units[].supplementary_data.cardreplace, add, remove
application_context.client_configurationreplace, add
", "operationId": "orders.patch", "responses": { "204": { "description": "A successful request returns the HTTP `204 No Content` status code with an empty object in the JSON response body." }, "400": { "description": "Request is not well-formed, syntactically incorrect, or violates schema.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/error_400" }, { "$ref": "#/components/schemas/orders.patch-400" } ] } } } }, "401": { "description": "Authentication failed due to missing authorization header, or invalid authentication credentials.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/error_401" }, { "$ref": "#/components/schemas/401" } ] } } } }, "404": { "description": "The specified resource does not exist.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/error_404" }, { "$ref": "#/components/schemas/404" } ] } } } }, "422": { "description": "The requested action could not be performed, semantically incorrect, or failed business validation.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/error_422" }, { "$ref": "#/components/schemas/orders.patch-422" } ] } } } }, "default": { "$ref": "#/components/responses/default" } }, "parameters": [ { "$ref": "#/components/parameters/id" }, { "$ref": "#/components/parameters/paypal_auth_assertion" } ], "requestBody": { "$ref": "#/components/requestBodies/patch_request" }, "security": [ { "Oauth2": [ "https://uri.paypal.com/services/payments/payment", "https://uri.paypal.com/services/payments/orders/deprecating-jssdk-migration-for-limited-merchants" ] } ], "tags": ["orders"] } }, "/v2/checkout/orders/{id}/confirm-payment-source": { "post": { "summary": "Confirm the Order", "description": "Payer confirms their intent to pay for the the Order with the given payment source.", "operationId": "orders.confirm", "responses": { "200": { "description": "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.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/order" } } } }, "400": { "description": "Request is not well-formed, syntactically incorrect, or violates schema.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/error_400" }, { "$ref": "#/components/schemas/orders.confirm-400" } ] } } } }, "403": { "description": "Authorization failed due to insufficient permissions.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/error_403" }, { "$ref": "#/components/schemas/403" } ] } } } }, "422": { "description": "The requested action could not be performed, semantically incorrect, or failed business validation.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/error_422" }, { "$ref": "#/components/schemas/orders.confirm-422" } ] } } } }, "500": { "description": "An internal server error has occurred.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_500" } } } }, "default": { "$ref": "#/components/responses/default" } }, "parameters": [ { "$ref": "#/components/parameters/paypal_client_metadata_id" }, { "$ref": "#/components/parameters/id" }, { "$ref": "#/components/parameters/paypal_auth_assertion" }, { "$ref": "#/components/parameters/prefer" } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/confirm_order_request" }, "examples": { "confirm_order_request": { "value": { "payment_source": { "paypal": { "name": { "given_name": "John", "surname": "Doe" }, "email_address": "customer@example.com", "experience_context": { "payment_method_preference": "IMMEDIATE_PAYMENT_REQUIRED", "payment_method_selected": "PAYPAL", "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" } } } } } } } } }, "security": [ { "Oauth2": [ "https://uri.paypal.com/services/payments/payment", "https://uri.paypal.com/services/payments/initiatepayment", "https://uri.paypal.com/services/payments/orders/client_sdk_orders_api" ] } ], "tags": ["orders"] } }, "/v2/checkout/orders/{id}/authorize": { "post": { "summary": "Authorize payment for order", "description": "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.
", "operationId": "orders.authorize", "responses": { "200": { "description": "A successful response to an idempotent request returns the HTTP `200 OK` status code with a JSON response body that shows authorized payment details.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/order_authorize_response" } } } }, "201": { "description": "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.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/order_authorize_response" } } } }, "400": { "description": "Request is not well-formed, syntactically incorrect, or violates schema.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/error_400" }, { "$ref": "#/components/schemas/orders.authorize-400" } ] } } } }, "401": { "description": "Authentication failed due to missing authorization header, or invalid authentication credentials.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/error_401" }, { "$ref": "#/components/schemas/401" } ] } } } }, "403": { "description": "The authorized payment failed due to insufficient permissions.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/error_403" }, { "$ref": "#/components/schemas/orders.authorize-403" } ] } } } }, "404": { "description": "The specified resource does not exist.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/error_404" }, { "$ref": "#/components/schemas/404" } ] } } } }, "422": { "description": "The requested action could not be performed, semantically incorrect, or failed business validation.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/error_422" }, { "$ref": "#/components/schemas/orders.authorize-422" } ] } } } }, "500": { "description": "An internal server error has occurred.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_500" } } } }, "default": { "$ref": "#/components/responses/default" } }, "parameters": [ { "$ref": "#/components/parameters/paypal_request_id" }, { "$ref": "#/components/parameters/prefer" }, { "$ref": "#/components/parameters/paypal_client_metadata_id" }, { "$ref": "#/components/parameters/id" }, { "$ref": "#/components/parameters/paypal_auth_assertion" } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/order_authorize_request" } } } }, "security": [ { "Oauth2": [ "https://uri.paypal.com/services/payments/payment", "https://uri.paypal.com/services/payments/orders/deprecating-jssdk-migration-for-limited-merchants" ] } ], "tags": ["orders"] } }, "/v2/checkout/orders/{id}/capture": { "post": { "summary": "Capture payment for order", "description": "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.
", "operationId": "orders.capture", "responses": { "200": { "description": "A successful response to an idempotent request returns the HTTP `200 OK` status code with a JSON response body that shows captured payment details.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/order" } } } }, "201": { "description": "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.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/order" } } } }, "400": { "description": "Request is not well-formed, syntactically incorrect, or violates schema.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/error_400" }, { "$ref": "#/components/schemas/orders.capture-400" } ] } } } }, "401": { "description": "Authentication failed due to missing authorization header, or invalid authentication credentials.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/error_401" }, { "$ref": "#/components/schemas/401" } ] } } } }, "403": { "description": "The authorized payment failed due to insufficient permissions.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/error_403" }, { "$ref": "#/components/schemas/orders.capture-403" } ] } } } }, "404": { "description": "The specified resource does not exist.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/error_404" }, { "$ref": "#/components/schemas/404" } ] } } } }, "422": { "description": "The requested action could not be performed, semantically incorrect, or failed business validation.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/error_422" }, { "$ref": "#/components/schemas/orders.capture-422" } ] } } } }, "500": { "description": "An internal server error has occurred.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_500" } } } }, "default": { "$ref": "#/components/responses/default" } }, "parameters": [ { "$ref": "#/components/parameters/paypal_request_id" }, { "$ref": "#/components/parameters/prefer" }, { "$ref": "#/components/parameters/paypal_client_metadata_id" }, { "$ref": "#/components/parameters/id" }, { "$ref": "#/components/parameters/paypal_auth_assertion" } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/order_capture_request" } } } }, "security": [ { "Oauth2": [ "https://uri.paypal.com/services/payments/payment", "https://uri.paypal.com/services/payments/orders/deprecating-jssdk-migration-for-limited-merchants" ] } ], "tags": ["orders"] } }, "/v2/checkout/orders/{id}/track": { "post": { "summary": "Add tracking information for an Order.", "description": "Adds tracking information for an Order.", "operationId": "orders.track.create", "responses": { "200": { "description": "A successful response to an idempotent request returns the HTTP `200 OK` status code with a JSON response body that shows tracker details.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/order" } } } }, "201": { "description": "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.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/order" } } } }, "400": { "description": "Request is not well-formed, syntactically incorrect, or violates schema.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/error_400" }, { "$ref": "#/components/schemas/orders.track.create-400" } ] } } } }, "403": { "description": "Authorization failed due to insufficient permissions.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/error_403" }, { "$ref": "#/components/schemas/orders.track.create-403" } ] } } } }, "404": { "description": "The specified resource does not exist.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/error_404" }, { "$ref": "#/components/schemas/404" } ] } } } }, "422": { "description": "The requested action could not be performed, semantically incorrect, or failed business validation.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/error_422" }, { "$ref": "#/components/schemas/orders.track.create-422" } ] } } } }, "500": { "description": "An internal server error has occurred.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_500" } } } }, "default": { "$ref": "#/components/responses/default" } }, "parameters": [ { "$ref": "#/components/parameters/id" }, { "$ref": "#/components/parameters/paypal_auth_assertion" } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/order_tracker_request" } } }, "required": true }, "security": [ { "Oauth2": ["https://uri.paypal.com/services/payments/payment"] } ], "tags": ["orders"] } }, "/v2/checkout/orders/{id}/trackers/{tracker_id}": { "patch": { "summary": "Update or cancel tracking information for an order", "description": "Updates or cancels the tracking information for a PayPal order, by ID. Updatable attributes or objects:

AttributeOpNotes
itemsreplaceUsing replace op for items will replace the entire items object with the value sent in request.
notify_payerreplace, add
statusreplaceOnly patching status to CANCELLED is currently supported.
", "operationId": "orders.trackers.patch", "responses": { "204": { "description": "A successful request returns the HTTP `204 No Content` status code with an empty object in the JSON response body." }, "400": { "description": "Request is not well-formed, syntactically incorrect, or violates schema.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/error_400" }, { "$ref": "#/components/schemas/orders.trackers.patch-400" } ] } } } }, "403": { "description": "Authorization failed due to insufficient permissions.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/error_403" }, { "$ref": "#/components/schemas/orders.trackers.patch-403" } ] } } } }, "404": { "description": "The specified resource does not exist.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/error_404" }, { "$ref": "#/components/schemas/orders.trackers.patch-404" } ] } } } }, "422": { "description": "The requested action could not be performed, semantically incorrect, or failed business validation.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/error_422" }, { "$ref": "#/components/schemas/orders.trackers.patch-422" } ] } } } }, "500": { "description": "An internal server error has occurred.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_500" } } } }, "default": { "$ref": "#/components/responses/default" } }, "parameters": [ { "$ref": "#/components/parameters/id" }, { "$ref": "#/components/parameters/tracker_id" }, { "$ref": "#/components/parameters/paypal_auth_assertion" } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/patch_request" }, "examples": { "orders_patch_request": { "value": [ { "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" } } ] } } } } }, "security": [ { "Oauth2": ["https://uri.paypal.com/services/payments/payment"] } ], "tags": ["trackers"] } }, "/v2/checkout/orders/order-update-callback": { "post": { "summary": "Receive updated order information via callback URL", "description": "The documentation for this 'endpoint' is different from the other endpoints under v2 Orders. For this endpoint the role of client and server is reversed. The client sending the request is PayPal, and the server sending the response is the merchant. In the request, PayPal will send the buyer's redacted shipping address and selected shipping option to the callback URL defined the create order request. The response from the merchant will update the Orders resource.", "operationId": "server.callback", "responses": { "200": { "description": "The callback to merchant was successful.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/order_update_callback_response" } } } }, "400": { "description": "The request is not well-formed, is syntactically incorrect, or violates the schema.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_400" } } } }, "403": { "description": "The transaction failed due to insufficient permissions.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_403" } } } }, "422": { "description": "The requested action could not be completed, was semantically incorrect, or failed business validation.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_422" } } } }, "500": { "description": "An internal server error has occurred.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_500" } } } }, "default": { "$ref": "#/components/responses/default" } }, "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/order_update_callback_request" } } } }, "tags": ["externalcallback"] } } }, "components": { "requestBodies": { "patch_request": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/patch_request" } } } } }, "securitySchemes": { "Oauth2": { "type": "oauth2", "description": "Oauth 2.0 authentication", "flows": { "clientCredentials": { "tokenUrl": "/v1/oauth2/token", "scopes": { "https://uri.paypal.com/services/payments/payment": "Manage payments and checkout workflow.", "https://uri.paypal.com/services/payments/payment/reference-transaction": "Permission to initiate reference transaction", "https://uri.paypal.com/services/payments/initiatepayment": "Initiates payments and checkout workflows.", "https://uri.paypal.com/services/payments/orders/deprecating-jssdk-migration-for-limited-merchants": "Allows client-side integration on Create, Get, Patch, Authorize & Capture Order endpoints.", "https://uri.paypal.com/services/payments/orders/client_sdk_orders_api": "Enables secure client-side integration on confirm payment source endpoint" } } } } }, "responses": { "default": { "description": "The default response.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_default" } } } } }, "schemas": { "400": { "properties": { "details": { "type": "array", "items": { "anyOf": [ { "title": "INVALID_ARRAY_MAX_ITEMS", "properties": { "issue": { "type": "string", "enum": ["INVALID_ARRAY_MAX_ITEMS"] }, "description": { "type": "string", "enum": [ "The number of items in an array parameter is too large." ] } } }, { "title": "INVALID_ARRAY_MIN_ITEMS", "properties": { "issue": { "type": "string", "enum": ["INVALID_ARRAY_MIN_ITEMS"] }, "description": { "type": "string", "enum": [ "The number of items in an array parameter is too small." ] } } }, { "title": "INVALID_COUNTRY_CODE", "properties": { "issue": { "type": "string", "enum": ["INVALID_COUNTRY_CODE"] }, "description": { "type": "string", "enum": [ "Country code is invalid. Please refer to https://developer.paypal.com/api/rest/reference/country-codes/ for a list of supported country codes." ] } } }, { "title": "INVALID_PARAMETER_SYNTAX", "properties": { "issue": { "type": "string", "enum": ["INVALID_PARAMETER_SYNTAX"] }, "description": { "type": "string", "enum": [ "The value of a field does not conform to the expected format." ] } } }, { "title": "INVALID_STRING_LENGTH", "properties": { "issue": { "type": "string", "enum": ["INVALID_STRING_LENGTH"] }, "description": { "type": "string", "enum": [ "The value of a field is either too short or too long" ] } } }, { "title": "INVALID_PARAMETER_VALUE", "properties": { "issue": { "type": "string", "enum": ["INVALID_PARAMETER_VALUE"] }, "description": { "type": "string", "enum": ["A parameter value is not valid."] } } }, { "title": "MISSING_REQUIRED_PARAMETER", "properties": { "issue": { "type": "string", "enum": ["MISSING_REQUIRED_PARAMETER"] }, "description": { "type": "string", "enum": ["A required parameter is missing."] } } }, { "title": "NOT_SUPPORTED", "properties": { "issue": { "type": "string", "enum": ["NOT_SUPPORTED"] }, "description": { "type": "string", "enum": ["This field is not currently supported."] } } }, { "title": "PAYPAL_REQUEST_ID_REQUIRED", "properties": { "issue": { "type": "string", "enum": ["PAYPAL_REQUEST_ID_REQUIRED"] }, "description": { "type": "string", "enum": [ "A PayPal-Request-Id is required if you are trying to process payment for an Order. Please specify a PayPal-Request-Id or Create the Order without a 'payment_source' specified." ] } } }, { "title": "MALFORMED_REQUEST_JSON", "properties": { "issue": { "type": "string", "enum": ["MALFORMED_REQUEST_JSON"] }, "description": { "type": "string", "enum": ["The request JSON is not well formed."] } } } ] } } } }, "401": { "properties": { "details": { "type": "array", "items": { "anyOf": [ { "title": "INVALID_ACCOUNT_STATUS", "properties": { "issue": { "type": "string", "enum": ["INVALID_ACCOUNT_STATUS"] }, "description": { "type": "string", "enum": ["Account validations failed for the user."] } } } ] } } } }, "403": { "properties": { "details": { "type": "array", "items": { "anyOf": [ { "title": "PERMISSION_DENIED", "properties": { "issue": { "type": "string", "enum": ["PERMISSION_DENIED"] }, "description": { "type": "string", "enum": [ "You do not have permission to access or perform operations on this resource." ] } } }, { "title": "NOT_ENABLED_FOR_CARD_PROCESSING", "properties": { "issue": { "type": "string", "enum": ["NOT_ENABLED_FOR_CARD_PROCESSING"] }, "description": { "type": "string", "enum": [ "The recipient for which the API call is made on behalf of is not enabled for card processing. Please contact PayPal customer support." ] } } }, { "title": "PAYEE_ACCOUNT_NOT_VERIFIED", "properties": { "issue": { "type": "string", "enum": ["PAYEE_ACCOUNT_NOT_VERIFIED"] }, "description": { "type": "string", "enum": [ "Payee has not verified their account with PayPal. The selected payment method requires the recipient to have a verified PayPal account before transactions can be processed on their behalf." ] } } } ] } } } }, "404": { "properties": { "details": { "type": "array", "items": { "anyOf": [ { "title": "INVALID_RESOURCE_ID", "properties": { "issue": { "type": "string", "enum": ["INVALID_RESOURCE_ID"] }, "description": { "type": "string", "enum": [ "Specified resource ID does not exist. Please check the resource ID and try again." ] } } } ] } } } }, "422": { "properties": { "details": { "type": "array", "items": { "anyOf": [ { "title": "AMOUNT_MISMATCH", "properties": { "issue": { "type": "string", "enum": ["AMOUNT_MISMATCH"] }, "description": { "type": "string", "enum": [ "Should equal item_total + tax_total + shipping + handling + insurance - shipping_discount - discount." ] } } }, { "title": "INVALID_POSTAL_CODE", "properties": { "issue": { "type": "string", "enum": ["INVALID_POSTAL_CODE"] }, "description": { "type": "string", "enum": [ "For vaulting with purchase, postal code (billing_address.postal_code) can only contain letters, numbers, spaces, and hyphens" ] } } }, { "title": "INVALID_POSTAL_CODE_LENGTH", "properties": { "issue": { "type": "string", "enum": ["INVALID_POSTAL_CODE_LENGTH"] }, "description": { "type": "string", "enum": [ "For vaulting with purchase, postal code (billing_address.postal_code) may contain no more than 9 letter or number characters" ] } } }, { "title": "BILLING_AGREEMENTS_CANNOT_BE_USED_FOR_SUBSCRIPTIONS", "properties": { "issue": { "type": "string", "enum": [ "BILLING_AGREEMENTS_CANNOT_BE_USED_FOR_SUBSCRIPTIONS" ] }, "description": { "type": "string", "enum": [ "Billing Agreements cannot be used for Subscription orders." ] } } }, { "title": "CANNOT_BE_NEGATIVE", "properties": { "issue": { "type": "string", "enum": ["CANNOT_BE_NEGATIVE"] }, "description": { "type": "string", "enum": [ "Must be greater than or equal to 0. If the currency supports decimals, only two decimal place precision is supported." ] } } }, { "title": "CANNOT_BE_ZERO_OR_NEGATIVE", "properties": { "issue": { "type": "string", "enum": ["CANNOT_BE_ZERO_OR_NEGATIVE"] }, "description": { "type": "string", "enum": [ "Must be greater than zero. If the currency supports decimals, only two decimal place precision is supported." ] } } }, { "title": "CARD_EXPIRED", "properties": { "issue": { "type": "string", "enum": ["CARD_EXPIRED"] }, "description": { "type": "string", "enum": ["The card is expired"] } } }, { "title": "MISSING_PREVIOUS_REFERENCE", "properties": { "issue": { "type": "string", "enum": ["MISSING_PREVIOUS_REFERENCE"] }, "description": { "type": "string", "enum": [ "For Merchant initiated network token transactions, either the payment_source.card.stored_credential.previous_network_transaction_reference or payment_source.card.stored_credential.previous_transaction_reference must be included in the request." ] } } }, { "title": "MISSING_CRYPTOGRAM", "properties": { "issue": { "type": "string", "enum": ["MISSING_CRYPTOGRAM"] }, "description": { "type": "string", "enum": [ "Cryptogram is mandatory for any customer initiated network token transactions." ] } } }, { "title": "CITY_REQUIRED", "properties": { "issue": { "type": "string", "enum": ["CITY_REQUIRED"] }, "description": { "type": "string", "enum": [ "The specified country requires a city (address.admin_area_2)." ] } } }, { "title": "DECIMAL_PRECISION", "properties": { "issue": { "type": "string", "enum": ["DECIMAL_PRECISION"] }, "description": { "type": "string", "enum": [ "If the currency supports decimals, only two decimal place precision is supported." ] } } }, { "title": "DONATION_ITEMS_NOT_SUPPORTED", "properties": { "issue": { "type": "string", "enum": ["DONATION_ITEMS_NOT_SUPPORTED"] }, "description": { "type": "string", "enum": [ "If 'purchase_unit' has \"DONATION\" as the 'items.category' then the Order can at most have one purchase_unit. Multiple purchase_units are not supported if either of them have at least one items with category as \"DONATION\"." ] } } }, { "title": "DUPLICATE_REFERENCE_ID", "properties": { "issue": { "type": "string", "enum": ["DUPLICATE_REFERENCE_ID"] }, "description": { "type": "string", "enum": [ "`reference_id` must be unique if multiple `purchase_unit` are provided." ] } } }, { "title": "INVALID_CURRENCY_CODE", "properties": { "issue": { "type": "string", "enum": ["INVALID_CURRENCY_CODE"] }, "description": { "type": "string", "enum": [ "Currency code is invalid or is not currently supported. Please refer https://developer.paypal.com/api/rest/reference/currency-codes/ for list of supported currency codes." ] } } }, { "title": "INVALID_PAYER_ID", "properties": { "issue": { "type": "string", "enum": ["INVALID_PAYER_ID"] }, "description": { "type": "string", "enum": ["The payer ID is not valid."] } } }, { "title": "ITEM_TOTAL_MISMATCH", "properties": { "issue": { "type": "string", "enum": ["ITEM_TOTAL_MISMATCH"] }, "description": { "type": "string", "enum": [ "Should equal sum of (unit_amount * quantity) across all items for a given purchase_unit." ] } } }, { "title": "ITEM_TOTAL_REQUIRED", "properties": { "issue": { "type": "string", "enum": ["ITEM_TOTAL_REQUIRED"] }, "description": { "type": "string", "enum": [ "If item details are specified (items.unit_amount and items.quantity) corresponding amount.breakdown.item_total is required." ] } } }, { "title": "MAX_VALUE_EXCEEDED", "properties": { "issue": { "type": "string", "enum": ["MAX_VALUE_EXCEEDED"] }, "description": { "type": "string", "enum": [ "Should be less than or equal to 999999999999999.99." ] } } }, { "title": "PAYMENT_DENIED", "properties": { "issue": { "type": "string", "enum": ["PAYMENT_DENIED"] }, "description": { "type": "string", "enum": [ "PayPal has declined to process this transaction." ] } } }, { "title": "MISSING_PICKUP_ADDRESS", "properties": { "issue": { "type": "string", "enum": ["MISSING_PICKUP_ADDRESS"] }, "description": { "type": "string", "enum": [ "A pickup address(`shipping.address`) is required for the provided `shipping.type`." ] } } }, { "title": "MULTI_CURRENCY_ORDER", "properties": { "issue": { "type": "string", "enum": ["MULTI_CURRENCY_ORDER"] }, "description": { "type": "string", "enum": [ "Multiple differing values of currency_code are not supported. Entire Order request must have the same currency_code." ] } } }, { "title": "MULTIPLE_ITEM_CATEGORIES", "properties": { "issue": { "type": "string", "enum": ["MULTIPLE_ITEM_CATEGORIES"] }, "description": { "type": "string", "enum": [ "For a given 'purchase_unit' the 'items.category' could be either \"PHYSICAL_GOODS\" and/or \"DIGITAL_GOODS\" or just \"DONATION\". 'items.category' as \"DONATION\" cannot be combined with items with either \"PHYSICAL_GOODS\" or \"DIGITAL_GOODS\"." ] } } }, { "title": "MULTIPLE_SHIPPING_ADDRESS_NOT_SUPPORTED", "properties": { "issue": { "type": "string", "enum": ["MULTIPLE_SHIPPING_ADDRESS_NOT_SUPPORTED"] }, "description": { "type": "string", "enum": ["Multiple shipping addresses are not supported."] } } }, { "title": "MULTIPLE_SHIPPING_TYPE_NOT_SUPPORTED", "properties": { "issue": { "type": "string", "enum": ["MULTIPLE_SHIPPING_TYPE_NOT_SUPPORTED"] }, "description": { "type": "string", "enum": [ "Different `shipping.type` are not supported across purchase units nor within an individual item's shipping options." ] } } }, { "title": "PAYEE_ACCOUNT_INVALID", "properties": { "issue": { "type": "string", "enum": ["PAYEE_ACCOUNT_INVALID"] }, "description": { "type": "string", "enum": [ "Payee account specified is invalid. Please check the `payee.email_address` or `payee.merchant_id` specified and try again. Ensure that either `payee.merchant_id` or `payee.email_address` is specified." ] } } }, { "title": "PAYEE_ACCOUNT_LOCKED_OR_CLOSED", "properties": { "issue": { "type": "string", "enum": ["PAYEE_ACCOUNT_LOCKED_OR_CLOSED"] }, "description": { "type": "string", "enum": ["The merchant account is locked or closed."] } } }, { "title": "PAYEE_ACCOUNT_RESTRICTED", "properties": { "issue": { "type": "string", "enum": ["PAYEE_ACCOUNT_RESTRICTED"] }, "description": { "type": "string", "enum": ["The merchant account is restricted."] } } }, { "title": "PAYMENT_ORIGIN_NOT_ENABLED", "properties": { "issue": { "type": "string", "enum": ["PAYMENT_ORIGIN_NOT_ENABLED"] }, "description": { "type": "string", "enum": [ "The API caller account or payee is not enabled for the given 'payment_origin' option. Please contact customer support for assistance." ] } } }, { "title": "PAYEE_PRICING_TIER_ID_NOT_ENABLED", "properties": { "issue": { "type": "string", "enum": ["PAYEE_PRICING_TIER_ID_NOT_ENABLED"] }, "description": { "type": "string", "enum": [ "The API Caller is not enabled to process transactions by specifying a 'payee_pricing_tier_id'. Please work with your Account Manager to enable this option for your account." ] } } }, { "title": "INVALID_PAYEE_PRICING_TIER_ID", "properties": { "issue": { "type": "string", "enum": ["INVALID_PAYEE_PRICING_TIER_ID"] }, "description": { "type": "string", "enum": [ "Please check the value specified or confirm with your Account Manager that the 'payee_pricing_tier_id' specified has been setup for the account." ] } } }, { "title": "UNSUPPORTED_PAYMENT_SOURCE_FOR_SUBSCRIPTIONS", "properties": { "issue": { "type": "string", "enum": ["UNSUPPORTED_PAYMENT_SOURCE_FOR_SUBSCRIPTIONS"] }, "description": { "type": "string", "enum": [ "The specified payment source is not supported for subscriptions. Only a `vault_id` or `vault_setup_token` with `payment_source.card` and `payment_source.paypal` are supported." ] } } }, { "title": "PAYEE_FX_RATE_ID_EXPIRED", "properties": { "issue": { "type": "string", "enum": ["PAYEE_FX_RATE_ID_EXPIRED"] }, "description": { "type": "string", "enum": [ "The specified FX Rate ID has expired. Please specify a different FX Rate Id and try the request again. Alternately, remove the FX Rate ID to process the request using the default exchange rate." ] } } }, { "title": "PAYEE_FX_RATE_ID_CURRENCY_MISMATCH", "properties": { "issue": { "type": "string", "enum": ["PAYEE_FX_RATE_ID_CURRENCY_MISMATCH"] }, "description": { "type": "string", "enum": [ "The specified FX Rate ID is for a currency that does not match with the currency of this request. Please specify a different FX Rate ID and try the request again. Alternately, remove the FX Rate ID to process the request using the default exchange rate." ] } } }, { "title": "INVALID_FX_RATE_ID", "properties": { "issue": { "type": "string", "enum": ["INVALID_FX_RATE_ID"] }, "description": { "type": "string", "enum": [ "The specific FX Rate ID is not valid. This could be either because we are not able to look up the FX Rate based on this ID or it could be because the ID belongs to another API Caller." ] } } }, { "title": "PLATFORM_FEES_NOT_SUPPORTED", "properties": { "issue": { "type": "string", "enum": ["PLATFORM_FEES_NOT_SUPPORTED"] }, "description": { "type": "string", "enum": [ "The API Caller is not enabled to process transactions by specifying 'platform_fees'. Please work with your PayPal Account Manager to enable this option for your account." ] } } }, { "title": "INVALID_PLATFORM_FEES_ACCOUNT", "properties": { "issue": { "type": "string", "enum": ["INVALID_PLATFORM_FEES_ACCOUNT"] }, "description": { "type": "string", "enum": [ "The specified platform_fees payee account is either invalid or account setup is incomplete.Please work with your PayPal Account Manager to enable this option for your account." ] } } }, { "title": "INVALID_PLATFORM_FEES_AMOUNT", "properties": { "issue": { "type": "string", "enum": ["INVALID_PLATFORM_FEES_AMOUNT"] }, "description": { "type": "string", "enum": [ "The platform_fees amount cannot be greater than order amount." ] } } }, { "title": "POSTAL_CODE_REQUIRED", "properties": { "issue": { "type": "string", "enum": ["POSTAL_CODE_REQUIRED"] }, "description": { "type": "string", "enum": ["The specified country requires a postal code."] } } }, { "title": "REFERENCE_ID_REQUIRED", "properties": { "issue": { "type": "string", "enum": ["REFERENCE_ID_REQUIRED"] }, "description": { "type": "string", "enum": [ "'reference_id' is required for each 'purchase_unit' if multiple 'purchase_unit' are provided." ] } } }, { "title": "SHIPPING_OPTIONS_NOT_SUPPORTED", "properties": { "issue": { "type": "string", "enum": ["SHIPPING_OPTIONS_NOT_SUPPORTED"] }, "description": { "type": "string", "enum": [ "Shipping options are not supported when `shipping.type` is specified or when 'application_context.shipping_preference' is set as 'NO_SHIPPING' or 'SET_PROVIDED_ADDRESS'." ] } } }, { "title": "TAX_TOTAL_MISMATCH", "properties": { "issue": { "type": "string", "enum": ["TAX_TOTAL_MISMATCH"] }, "description": { "type": "string", "enum": [ "Should equal sum of (tax * quantity) across all items for a given purchase_unit." ] } } }, { "title": "TAX_TOTAL_REQUIRED", "properties": { "issue": { "type": "string", "enum": ["TAX_TOTAL_REQUIRED"] }, "description": { "type": "string", "enum": [ "If item details are specified (items.tax_total and items.quantity) corresponding amount.breakdown.tax_total is required." ] } } }, { "title": "UNSUPPORTED_INTENT", "properties": { "issue": { "type": "string", "enum": ["UNSUPPORTED_INTENT"] }, "description": { "type": "string", "enum": [ "`intent=AUTHORIZE` is not supported for this operation. Only `intent=CAPTURE` is supported." ] } } }, { "title": "UNSUPPORTED_INTENT_FOR_KYC_INCOMPLETE_PAYEE", "properties": { "issue": { "type": "string", "enum": ["UNSUPPORTED_INTENT_FOR_KYC_INCOMPLETE_PAYEE"] }, "description": { "type": "string", "enum": [ "`intent=AUTHORIZE` is not supported due to payee's incomplete KYC, while their partner is enabled for Progressive Onboarding. Only `intent=CAPTURE` is supported." ] } } }, { "title": "UNSUPPORTED_PAYMENT_INSTRUCTION", "properties": { "issue": { "type": "string", "enum": ["UNSUPPORTED_PAYMENT_INSTRUCTION"] }, "description": { "type": "string", "enum": [ "You must provide the payment instruction when you capture an authorized payment for `intent=AUTHORIZE`. For details, see Capture authorization. For `intent=CAPTURE`, send the payment instruction when you create the order." ] } } }, { "title": "SHIPPING_TYPE_NOT_SUPPORTED_FOR_CLIENT", "properties": { "issue": { "type": "string", "enum": ["SHIPPING_TYPE_NOT_SUPPORTED_FOR_CLIENT"] }, "description": { "type": "string", "enum": [ "The API Caller account is not setup to be able to support a `shipping.type`=`PICKUP_IN_PERSON`. This feature is only supported for PayPal Complete Payments Platform for Platforms and Marketplaces." ] } } }, { "title": "UNSUPPORTED_SHIPPING_TYPE", "properties": { "issue": { "type": "string", "enum": ["UNSUPPORTED_SHIPPING_TYPE"] }, "description": { "type": "string", "enum": [ "The provided `shipping.type` is only supported for `application_context.shipping_preference`=`SET_PROVIDED_ADDRESS` or `NO_SHIPPING`." ] } } }, { "title": "SHIPPING_OPTION_NOT_SELECTED", "properties": { "issue": { "type": "string", "enum": ["SHIPPING_OPTION_NOT_SELECTED"] }, "description": { "type": "string", "enum": [ "At least one of the shipping.option should be set to 'selected = true'." ] } } }, { "title": "MULTIPLE_SHIPPING_OPTION_SELECTED", "properties": { "issue": { "type": "string", "enum": ["MULTIPLE_SHIPPING_OPTION_SELECTED"] }, "description": { "type": "string", "enum": [ "Only one shipping.option can be set to 'selected = true'." ] } } }, { "title": "INVALID_SHIPPING_OPTION_ID", "properties": { "issue": { "type": "string", "enum": ["INVALID_SHIPPING_OPTION_ID"] }, "description": { "type": "string", "enum": [ "The items.shipping.options_ids[].id does not exist in purchase_units.shipping.options[]. Please ensure that all ids used in options_ids are first defined in purchase_units.shipping.options[]." ] } } }, { "title": "INVALID_DELIVERY_ESTIMATE", "properties": { "issue": { "type": "string", "enum": ["INVALID_DELIVERY_ESTIMATE"] }, "description": { "type": "string", "enum": [ "The provided `delivery_time_max` must be greater than the `delivery_time_min`, and vice versa." ] } } }, { "title": "INELIGIBLE_SHIPPING_OPTION", "properties": { "issue": { "type": "string", "enum": ["INELIGIBLE_SHIPPING_OPTION"] }, "description": { "type": "string", "enum": [ "One or more shipping options cannot be used in conjunction with this Order." ] } } }, { "title": "MISSING_SHIPPING_CALL_BACK_CONFIGURATION", "properties": { "issue": { "type": "string", "enum": ["MISSING_SHIPPING_CALL_BACK_CONFIGURATION"] }, "description": { "type": "string", "enum": [ "`payment_source.paypal.experience_context.order_update_callback_config` is mandatory for one or more shipping.options provided in the request." ] } } }, { "title": "MISSING_ITEM_SHIPPING_OPTIONS", "properties": { "issue": { "type": "string", "enum": ["MISSING_ITEM_SHIPPING_OPTIONS"] }, "description": { "type": "string", "enum": [ "All items in the purchase_unit must have `options_ids` defined if any item in the Order has `item[].shipping.options_ids` defined." ] } } }, { "title": "PREFERRED_SHIPPING_OPTION_AMOUNT_MISMATCH", "properties": { "issue": { "type": "string", "enum": ["PREFERRED_SHIPPING_OPTION_AMOUNT_MISMATCH"] }, "description": { "type": "string", "enum": [ "The amount provided in the preferred shipping option should match the amount provided in amount breakdown" ] } } }, { "title": "AGREEMENT_ALREADY_CANCELLED", "properties": { "issue": { "type": "string", "enum": ["AGREEMENT_ALREADY_CANCELLED"] }, "description": { "type": "string", "enum": ["The requested agreement is already canceled."] } } }, { "title": "BILLING_AGREEMENT_NOT_FOUND", "properties": { "issue": { "type": "string", "enum": ["BILLING_AGREEMENT_NOT_FOUND"] }, "description": { "type": "string", "enum": [ "The requested Billing Agreement token was not found." ] } } }, { "title": "COMPLIANCE_VIOLATION", "properties": { "issue": { "type": "string", "enum": ["COMPLIANCE_VIOLATION"] }, "description": { "type": "string", "enum": [ "Transaction is declined due to compliance violation." ] } } }, { "title": "DOMESTIC_TRANSACTION_REQUIRED", "properties": { "issue": { "type": "string", "enum": ["DOMESTIC_TRANSACTION_REQUIRED"] }, "description": { "type": "string", "enum": [ "This transaction requires the payee and payer to be resident in the same country, a domestic transaction is required to create this payment." ] } } }, { "title": "DUPLICATE_INVOICE_ID", "properties": { "issue": { "type": "string", "enum": ["DUPLICATE_INVOICE_ID"] }, "description": { "type": "string", "enum": [ "Duplicate Invoice ID detected. To avoid a potential duplicate transaction your account setting requires that Invoice Id be unique for each transaction." ] } } }, { "title": "INSTRUMENT_DECLINED", "properties": { "issue": { "type": "string", "enum": ["INSTRUMENT_DECLINED"] }, "description": { "type": "string", "enum": [ "The instrument presented was either declined by the processor or bank, or it can't be used for this payment." ] } } }, { "title": "MAX_NUMBER_OF_PAYMENT_ATTEMPTS_EXCEEDED", "properties": { "issue": { "type": "string", "enum": ["MAX_NUMBER_OF_PAYMENT_ATTEMPTS_EXCEEDED"] }, "description": { "type": "string", "enum": [ "You have exceeded the maximum number of payment attempts." ] } } }, { "title": "NOT_ENABLED_FOR_CARD_PROCESSING", "properties": { "issue": { "type": "string", "enum": ["NOT_ENABLED_FOR_CARD_PROCESSING"] }, "description": { "type": "string", "enum": [ "The API Caller account is not setup to be able to process card payments. Please contact PayPal customer support." ] } } }, { "title": "PAYEE_BLOCKED_TRANSACTION", "properties": { "issue": { "type": "string", "enum": ["PAYEE_BLOCKED_TRANSACTION"] }, "description": { "type": "string", "enum": [ "Declined by fraud tool (Fraud Protection/Chargeback Protection) due to potential fraud risk. Please review your fraud settings." ] } } }, { "title": "PAYER_ACCOUNT_LOCKED_OR_CLOSED", "properties": { "issue": { "type": "string", "enum": ["PAYER_ACCOUNT_LOCKED_OR_CLOSED"] }, "description": { "type": "string", "enum": [ "The payer account cannot be used for this transaction." ] } } }, { "title": "PAYER_ACCOUNT_RESTRICTED", "properties": { "issue": { "type": "string", "enum": ["PAYER_ACCOUNT_RESTRICTED"] }, "description": { "type": "string", "enum": ["PAYER_ACCOUNT_RESTRICTED"] } } }, { "title": "PAYER_CANNOT_PAY", "properties": { "issue": { "type": "string", "enum": ["PAYER_CANNOT_PAY"] }, "description": { "type": "string", "enum": [ "Combination of payer and payee settings mean that this buyer cannot pay this seller." ] } } }, { "title": "TRANSACTION_BLOCKED_BY_PAYEE", "properties": { "issue": { "type": "string", "enum": ["TRANSACTION_BLOCKED_BY_PAYEE"] }, "description": { "type": "string", "enum": [ "Transaction blocked by Payee’s Fraud Protection settings." ] } } }, { "title": "TRANSACTION_LIMIT_EXCEEDED", "properties": { "issue": { "type": "string", "enum": ["TRANSACTION_LIMIT_EXCEEDED"] }, "description": { "type": "string", "enum": [ "Total payment amount exceeded transaction limit." ] } } }, { "title": "TRANSACTION_RECEIVING_LIMIT_EXCEEDED", "properties": { "issue": { "type": "string", "enum": ["TRANSACTION_RECEIVING_LIMIT_EXCEEDED"] }, "description": { "type": "string", "enum": [ "The transaction exceeds the receiver's receiving limit." ] } } }, { "title": "TRANSACTION_REFUSED", "properties": { "issue": { "type": "string", "enum": ["TRANSACTION_REFUSED"] }, "description": { "type": "string", "enum": ["The request was refused."] } } }, { "title": "AUTH_CAPTURE_NOT_ENABLED", "properties": { "issue": { "type": "string", "enum": ["AUTH_CAPTURE_NOT_ENABLED"] }, "description": { "type": "string", "enum": [ "Authorization and Capture feature is not enabled for the merchant. Make sure that the recipient of the funds is a verified business account." ] } } }, { "title": "UNSUPPORTED_PROCESSING_INSTRUCTION", "properties": { "issue": { "type": "string", "enum": ["UNSUPPORTED_PROCESSING_INSTRUCTION"] }, "description": { "type": "string", "enum": [ "The specified processing_instruction is not supported for the given payment_source. Please refer to https://developer.paypal.com/api/orders/v2/#definition-processing_instruction for the list of payment_source that can be specified with this value." ] } } }, { "title": "ORDER_COMPLETE_ON_PAYMENT_APPROVAL", "properties": { "issue": { "type": "string", "enum": ["ORDER_COMPLETE_ON_PAYMENT_APPROVAL"] }, "description": { "type": "string", "enum": [ "A processing_instruction of `ORDER_COMPLETE_ON_PAYMENT_APPROVAL` is required for the specified payment_source. Please refer to the integration guide https://developer.paypal.com/docs/limited-release/alternative-payment-methods-with-orders/ for more details" ] } } }, { "title": "INVALID_EXPIRY_DATE", "properties": { "issue": { "type": "string", "enum": ["INVALID_EXPIRY_DATE"] }, "description": { "type": "string", "enum": [ "Expiry date is invalid. Expiry date should be a date in future and within the threshold for the payment source." ] } } }, { "title": "INCOMPATIBLE_PARAMETER_VALUE", "properties": { "issue": { "type": "string", "enum": ["INCOMPATIBLE_PARAMETER_VALUE"] }, "description": { "type": "string", "enum": [ "The value of the field is incompatible/redundant with other fields in the order." ] } } }, { "title": "INVALID_PREVIOUS_TRANSACTION_REFERENCE", "properties": { "issue": { "type": "string", "enum": ["INVALID_PREVIOUS_TRANSACTION_REFERENCE"] }, "description": { "type": "string", "enum": [ "The authorization or capture referenced by `previous_transaction_reference` is not valid. This could be either because the previous_transaction_reference is not found or doesn't belong to the payee. Please use a valid `previous_transaction_reference`." ] } } }, { "title": "PREVIOUS_TRANSACTION_REFERENCE_HAS_CHARGEBACK", "properties": { "issue": { "type": "string", "enum": ["PREVIOUS_TRANSACTION_REFERENCE_HAS_CHARGEBACK"] }, "description": { "type": "string", "enum": [ "The capture referenced by `previous_transaction_reference` has a chargeback and hence cannot be used for this order. Please use a `previous_transaction_reference` which does not have a chargeback." ] } } }, { "title": "PREVIOUS_TRANSACTION_REFERENCE_VOIDED", "properties": { "issue": { "type": "string", "enum": ["PREVIOUS_TRANSACTION_REFERENCE_VOIDED"] }, "description": { "type": "string", "enum": [ "The status of authorization referenced by `previous_transaction_reference` is `VOIDED` and hence cannot be used for this order. Please use a `previous_transaction_reference` whose status is not `VOIDED`." ] } } }, { "title": "PAYMENT_SOURCE_MISMATCH", "properties": { "issue": { "type": "string", "enum": ["PAYMENT_SOURCE_MISMATCH"] }, "description": { "type": "string", "enum": [ "The `payment_source` in the request must match the `payment_source` used for the authorization or capture referenced by `previous_transaction_reference`. Please use `previous_transaction_reference` whose `payment_source` matches with the `payment_source` specified in the order." ] } } }, { "title": "MERCHANT_INITIATED_WITH_SECURITY_CODE", "properties": { "issue": { "type": "string", "enum": ["MERCHANT_INITIATED_WITH_SECURITY_CODE"] }, "description": { "type": "string", "enum": [ "`stored_payment_source.payment_initiator` = `MERCHANT` is not supported if `payment_source.card.security_code` is present in the order. `security_code` can be present in the order only when customer is the payment initiator. It is semantically incorrect to perform a merchant initiated payment with `security_code` is the order." ] } } }, { "title": "MERCHANT_INITIATED_WITH_AUTHENTICATION_RESULTS", "properties": { "issue": { "type": "string", "enum": ["MERCHANT_INITIATED_WITH_AUTHENTICATION_RESULTS"] }, "description": { "type": "string", "enum": [ "`stored_payment_source.payment_initiator` = `MERCHANT` is not supported if 3D-Secure authentication results are present in the order. 3D-Secure authentication results can be present in the order only when customer is the payment initiator. It is semantically incorrect to perform a merchant initiated payment with 3D-Secure authentication results is the order." ] } } }, { "title": "MERCHANT_INITIATED_WITH_MULTIPLE_PURCHASE_UNITS", "properties": { "issue": { "type": "string", "enum": [ "MERCHANT_INITIATED_WITH_MULTIPLE_PURCHASE_UNITS" ] }, "description": { "type": "string", "enum": [ "`stored_payment_source.payment_initiator` = `MERCHANT` is not supported if more than one purchase_unit is present in the Order. Merchant initiated payments are not supported from orders with more than one purchase_unit. Please retry the request with multiple Order requests (one for each purchase_unit)." ] } } }, { "title": "PAYMENT_SOURCE_INFO_CANNOT_BE_VERIFIED", "properties": { "issue": { "type": "string", "enum": ["PAYMENT_SOURCE_INFO_CANNOT_BE_VERIFIED"] }, "description": { "type": "string", "enum": [ "The combination of the payment_source name, billing address, shipping name and shipping address could not be verified. Please correct this information and try again by creating a new order." ] } } }, { "title": "PAYMENT_SOURCE_DECLINED_BY_PROCESSOR", "properties": { "issue": { "type": "string", "enum": ["PAYMENT_SOURCE_DECLINED_BY_PROCESSOR"] }, "description": { "type": "string", "enum": [ "The provided payment source is declined by the processor. Please try again with a different payment source by creating a new order." ] } } }, { "title": "PAYMENT_SOURCE_CANNOT_BE_USED", "properties": { "issue": { "type": "string", "enum": ["PAYMENT_SOURCE_CANNOT_BE_USED"] }, "description": { "type": "string", "enum": [ "The provided payment source cannot be used to pay for the order. Please try again with a different payment source by creating a new order." ] } } }, { "title": "NOT_ENABLED_FOR_APPLE_PAY", "properties": { "issue": { "type": "string", "enum": ["NOT_ENABLED_FOR_APPLE_PAY"] }, "description": { "type": "string", "enum": [ "The 'API caller' and/or 'payee' is not setup to be able to process apple pay. Please contact your Account Manager." ] } } }, { "title": "NOT_ENABLED_FOR_GOOGLE_PAY", "properties": { "issue": { "type": "string", "enum": ["NOT_ENABLED_FOR_GOOGLE_PAY"] }, "description": { "type": "string", "enum": [ "The 'API caller' and/or 'payee' is not setup to be able to process google pay. Please contact your Account Manager." ] } } }, { "title": "APPLE_PAY_AMOUNT_MISMATCH", "properties": { "issue": { "type": "string", "enum": ["APPLE_PAY_AMOUNT_MISMATCH"] }, "description": { "type": "string", "enum": [ "The 'amount' specified in the Order should match the amount that was viewed and authorized by the payer/buyer on Apple Pay. If the amount has changed, please redirect the buyer to authorize the order again via Apple Pay." ] } } }, { "title": "BILLING_ADDRESS_INVALID", "properties": { "issue": { "type": "string", "enum": ["BILLING_ADDRESS_INVALID"] }, "description": { "type": "string", "enum": ["Provided billing address is invalid."] } } }, { "title": "SHIPPING_ADDRESS_INVALID", "properties": { "issue": { "type": "string", "enum": ["SHIPPING_ADDRESS_INVALID"] }, "description": { "type": "string", "enum": ["Provided shipping address is invalid."] } } }, { "title": "VAULT_INSTRUCTION_DUPLICATED", "properties": { "issue": { "type": "string", "enum": ["VAULT_INSTRUCTION_DUPLICATED"] }, "description": { "type": "string", "enum": [ "Only one vault instruction is allowed. Please use `vault.store_in_vault` to provide vault instruction." ] } } }, { "title": "VAULT_INSTRUCTION_REQUIRED", "properties": { "issue": { "type": "string", "enum": ["VAULT_INSTRUCTION_REQUIRED"] }, "description": { "type": "string", "enum": [ "Vault instruction is required. Please use `vault.store_in_vault` to provide vault instruction." ] } } }, { "title": "MISMATCHED_VAULT_OWNER_ID", "properties": { "issue": { "type": "string", "enum": ["MISMATCHED_VAULT_OWNER_ID"] }, "description": { "type": "string", "enum": [ "The owner_id does not match with the API caller. Please verify that the owner_id is same as the API caller's payer id." ] } } }, { "title": "VAULT_OWNER_ID_NOT_SUPPORTED", "properties": { "issue": { "type": "string", "enum": ["VAULT_OWNER_ID_NOT_SUPPORTED"] }, "description": { "type": "string", "enum": [ "API caller is not enabled to specify the vault owner_id explicitly. Please contact your account manager to enable the functionality." ] } } }, { "title": "MISMATCHED_VAULT_ID_TO_PAYMENT_SOURCE", "properties": { "issue": { "type": "string", "enum": ["MISMATCHED_VAULT_ID_TO_PAYMENT_SOURCE"] }, "description": { "type": "string", "enum": [ "The vault_id does not match the payment_source provided. Please verify that the vault_id token used refers to the matching payment_source and try again. For example, a PayPal token cannot be passed in the vault_id field in the payment_source.card object." ] } } }, { "title": "MISMATCHED_VAULT_SETUP_TOKEN_TO_PAYMENT_SOURCE", "properties": { "issue": { "type": "string", "enum": ["MISMATCHED_VAULT_SETUP_TOKEN_TO_PAYMENT_SOURCE"] }, "description": { "type": "string", "enum": [ "The `vault_setup_token` does not match the payment_source provided. Please verify that the `vault_setup_token` token used refers to the matching payment_source and try again. For example, a PayPal token cannot be passed in the `vault_setup_token` field in the `payment_source.card` object." ] } } }, { "title": "CRYPTOGRAM_REQUIRED", "properties": { "issue": { "type": "string", "enum": ["CRYPTOGRAM_REQUIRED"] }, "description": { "type": "string", "enum": [ "Cryptogram is required if authentication method is CRYPTOGRAM 3DS." ] } } }, { "title": "EMV_DATA_REQUIRED", "properties": { "issue": { "type": "string", "enum": ["EMV_DATA_REQUIRED"] }, "description": { "type": "string", "enum": [ "EMV Data is required if authentication method is EMV." ] } } }, { "title": "NOT_ELIGIBLE_FOR_PNREF_PROCESSING", "properties": { "issue": { "type": "string", "enum": ["NOT_ELIGIBLE_FOR_PNREF_PROCESSING"] }, "description": { "type": "string", "enum": [ "API caller is not enabled to process payments with the `pnref`. Please contact customer support to request permissions to process transactions with PNREF." ] } } }, { "title": "NOT_ELIGIBLE_FOR_PAYPAL_TRANSACTION_ID_PROCESSING", "properties": { "issue": { "type": "string", "enum": [ "NOT_ELIGIBLE_FOR_PAYPAL_TRANSACTION_ID_PROCESSING" ] }, "description": { "type": "string", "enum": [ "API caller is not enable to process payments using `paypal_transaction_id`. Please contact customer support to request permissions to process transactions with PayPal transaction ID." ] } } }, { "title": "PAYPAL_TRANSACTION_ID_NOT_FOUND", "properties": { "issue": { "type": "string", "enum": ["PAYPAL_TRANSACTION_ID_NOT_FOUND"] }, "description": { "type": "string", "enum": [ "Specified `paypal_transaction_id` was not found. Verify the value and try the request again." ] } } }, { "title": "PNREF_NOT_FOUND", "properties": { "issue": { "type": "string", "enum": ["PNREF_NOT_FOUND"] }, "description": { "type": "string", "enum": [ "Specified `pnref` was not found. Verify the value and try the request again." ] } } }, { "title": "INVALID_SECURITY_CODE_LENGTH", "properties": { "issue": { "type": "string", "enum": ["INVALID_SECURITY_CODE_LENGTH"] }, "description": { "type": "string", "enum": [ "The security_code length is invalid for the specified card brand." ] } } }, { "title": "NOT_ENABLED_TO_VAULT_PAYMENT_SOURCE", "properties": { "issue": { "type": "string", "enum": ["NOT_ENABLED_TO_VAULT_PAYMENT_SOURCE"] }, "description": { "type": "string", "enum": [ "The API caller or the merchant on whose behalf the API call is initiated is not allowed to vault the given source. Please contact PayPal customer support for assistance." ] } } }, { "title": "REQUIRED_PARAMETER_FOR_CUSTOMER_INITIATED_PAYMENT", "properties": { "issue": { "type": "string", "enum": [ "REQUIRED_PARAMETER_FOR_CUSTOMER_INITIATED_PAYMENT" ] }, "description": { "type": "string", "enum": [ "This parameter is required when the customer is present. If the customer is not present, indicate so by sending payment_initiator=`MERCHANT`. For details, see Stored Credential." ] } } }, { "title": "TOKEN_EXPIRED", "properties": { "issue": { "type": "string", "enum": ["TOKEN_EXPIRED"] }, "description": { "type": "string", "enum": [ "The token is expired and cannot be used for payment." ] } } }, { "title": "INVALID_GOOGLE_PAY_TOKEN", "properties": { "issue": { "type": "string", "enum": ["INVALID_GOOGLE_PAY_TOKEN"] }, "description": { "type": "string", "enum": [ "The google pay token is invalid. PayPal was not able to decrypt the googlepay token or PayPal was not able to find the necessary data in the token after decryption." ] } } }, { "title": "GOOGLE_PAY_GATEWAY_MERCHANT_ID_MISMATCH", "properties": { "issue": { "type": "string", "enum": ["GOOGLE_PAY_GATEWAY_MERCHANT_ID_MISMATCH"] }, "description": { "type": "string", "enum": [ "The gateway merchant ID in Google Pay token is not valid. This could be because the gateway merchant Id that was authorized by payer/buyer on Google Pay does not match with the API caller of the order." ] } } }, { "title": "CRYPTOGRAM_REQUIRED", "properties": { "issue": { "type": "string", "enum": ["CRYPTOGRAM_REQUIRED"] }, "description": { "type": "string", "enum": [ "Cryptogram is required if authentication method is CRYPTOGRAM 3DS." ] } } }, { "title": "ONE_OF_PARAMETERS_REQUIRED", "properties": { "issue": { "type": "string", "enum": ["ONE_OF_PARAMETERS_REQUIRED"] }, "description": { "type": "string", "enum": [ "One or more field is required to continue with this request." ] } } }, { "title": "ALIAS_DECLINED_BY_PROCESSOR", "properties": { "issue": { "type": "string", "enum": ["ALIAS_DECLINED_BY_PROCESSOR"] }, "description": { "type": "string", "enum": [ "The provided alias was declined by the processor. Please create a new order with a different alias_key and/or alias_label and try again." ] } } }, { "title": "PREFERRED_BRAND_NOT_SUPPORTED", "properties": { "issue": { "type": "string", "enum": ["PREFERRED_BRAND_NOT_SUPPORTED"] }, "description": { "type": "string", "enum": [ "Processing of this preferred brand is not supported. Please use another brand preference to continue with this transaction." ] } } }, { "title": "BLIK_ONE_CLICK_MISSING_REQUIRED_PARAMETER", "properties": { "issue": { "type": "string", "enum": ["BLIK_ONE_CLICK_MISSING_REQUIRED_PARAMETER"] }, "description": { "type": "string", "enum": [ "Blik's one_click flow requires one_click.auth_code and one_click.alias_label parameters for the buyer's first transaction. For all subsequent transactions,only the one_click.alias_key parameter is required." ] } } }, { "title": "INCOMPATIBLE_ACCOUNT_OWNERSHIP_TYPE", "properties": { "issue": { "type": "string", "enum": ["INCOMPATIBLE_ACCOUNT_OWNERSHIP_TYPE"] }, "description": { "type": "string", "enum": [ "Account ownership type is not compatible with standard entry class code." ] } } }, { "title": "DELAYED_DISBURSEMENT_NOT_SUPPORTED", "properties": { "issue": { "type": "string", "enum": ["DELAYED_DISBURSEMENT_NOT_SUPPORTED"] }, "description": { "type": "string", "enum": [ "The API Caller is not enabled to process transactions by specifying disbursement mode as delayed." ] } } }, { "title": "DELAYED_DISBURSEMENT_NOT_SUPPORTED_FOR_KYC_INCOMPLETE_PAYEE", "properties": { "issue": { "type": "string", "enum": [ "DELAYED_DISBURSEMENT_NOT_SUPPORTED_FOR_KYC_INCOMPLETE_PAYEE" ] }, "description": { "type": "string", "enum": [ "The Delayed disbursement is not supported due to payee's incomplete KYC, while their partner is enabled for Progressive Onboarding." ] } } }, { "title": "PARTNER_SETTLEMENT_NOT_SUPPORTED_FOR_KYC_INCOMPLETE_PAYEE", "properties": { "issue": { "type": "string", "enum": [ "PARTNER_SETTLEMENT_NOT_SUPPORTED_FOR_KYC_INCOMPLETE_PAYEE" ] }, "description": { "type": "string", "enum": [ "Partner settlement is not supported due to payee's incomplete KYC, while their partner is enabled for Progressive Onboarding." ] } } }, { "title": "NOT_ENABLED_FOR_PAYMENT_SOURCE", "properties": { "issue": { "type": "string", "enum": ["NOT_ENABLED_FOR_PAYMENT_SOURCE"] }, "description": { "type": "string", "enum": [ "The 'API caller' and/or 'payee' is not setup to be able to process the selected payment source. If you have already completed the required steps, please allow 2 business days for PayPal to complete the setup. If you continue to receive this error, please contact your Account Manager or check status at https://www.paypal.com/businessmanage/account/payments." ] } } }, { "title": "INVALID_VAULT_ID", "properties": { "issue": { "type": "string", "enum": ["INVALID_VAULT_ID"] }, "description": { "type": "string", "enum": [ "The specified Vault ID is invalid or could not be found." ] } } }, { "title": "MULTIPLE_PURCHASE_UNITS_NOT_SUPPORTED_FOR_PAYMENT_SOURCE", "properties": { "issue": { "type": "string", "enum": [ "MULTIPLE_PURCHASE_UNITS_NOT_SUPPORTED_FOR_PAYMENT_SOURCE" ] }, "description": { "type": "string", "enum": [ "The provided payment source cannot be used to pay for the multiple purchase units order." ] } } }, { "title": "COUNTRY_NOT_SUPPORTED_BY_PAYMENT_SOURCE", "properties": { "issue": { "type": "string", "enum": ["COUNTRY_NOT_SUPPORTED_BY_PAYMENT_SOURCE"] }, "description": { "type": "string", "enum": [ "Country code provided is not supported by the provided payment source." ] } } }, { "title": "LOCALE_NOT_SUPPORTED_BY_PAYMENT_SOURCE", "properties": { "issue": { "type": "string", "enum": ["LOCALE_NOT_SUPPORTED_BY_PAYMENT_SOURCE"] }, "description": { "type": "string", "enum": [ "Locale provided is not supported by the provided payment source." ] } } }, { "title": "BANK_VERIFICATION_REQUIRED", "properties": { "issue": { "type": "string", "enum": ["BANK_VERIFICATION_REQUIRED"] }, "description": { "type": "string", "enum": ["Only verified bank accounts can be processed."] } } }, { "title": "SHIPPING_CALLBACK_CONFIG_NOT_SUPPORTED", "properties": { "issue": { "type": "string", "enum": ["SHIPPING_CALLBACK_CONFIG_NOT_SUPPORTED"] }, "description": { "type": "string", "enum": [ "The shipping address callback URL in 'order_update_callback_config' field is not supported when `shipping.type` is specified or when 'application_context.shipping_preference' is set as 'NO_SHIPPING' or 'SET_PROVIDED_ADDRESS'." ] } } }, { "title": "MISSING_REQUIRED_PARAMETER_FOR_BILLING_PLAN", "properties": { "issue": { "type": "string", "enum": ["MISSING_REQUIRED_PARAMETER_FOR_BILLING_PLAN"] }, "description": { "type": "string", "enum": [ "PayPal Vault billing plan requires usage_pattern to be passed in the request. Supported Values: SUBSCRIPTION, UNSCHEDULED, RECURRING, INSTALLMENT (prepaid/postpaid)" ] } } }, { "title": "UNSUPPORTED_INTEGRATION_FOR_BILLING_PLAN", "properties": { "issue": { "type": "string", "enum": ["UNSUPPORTED_INTEGRATION_FOR_BILLING_PLAN"] }, "description": { "type": "string", "enum": [ "For Recurring Purchases, passing billing plan and vaulting instruction (in payment_source.paypal.attributes.vault or payment_source.paypal.billing) is mandatory. Also, only one billing plan, product and purchase unit are supported." ] } } }, { "title": "INCOMPATIBLE_PARAMETER_FOR_BILLING_PLAN", "properties": { "issue": { "type": "string", "enum": ["INCOMPATIBLE_PARAMETER_FOR_BILLING_PLAN"] }, "description": { "type": "string", "enum": [ "For Recurring Purchase, amount fields like handling, insurance, discount and shipping discount are unsupported." ] } } }, { "title": "BILLING_ITEM_AMOUNT_MISMATCH", "properties": { "issue": { "type": "string", "enum": ["BILLING_ITEM_AMOUNT_MISMATCH"] }, "description": { "type": "string", "enum": [ "For Recurring Purchases, the billing plan’s unit amount should include both the setup fee and the plan price (only if the plan starts immediately, i.e. no start_date)." ] } } } ] } } } }, "account_id": { "type": "string", "title": "PayPal Account Identifier", "description": "The account identifier for a PayPal account.", "format": "ppaas_payer_id_v3", "minLength": 13, "maxLength": 13, "pattern": "^[2-9A-HJ-NP-Z]{13}$" }, "account_id-2": { "type": "string", "description": "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.", "format": "ppaas_payer_id_v3", "minLength": 13, "maxLength": 13, "pattern": "^[2-9A-HJ-NP-Z]{13}$" }, "activity_timestamps": { "type": "object", "description": "The date and time stamps that are common to authorized payment, captured payment, and refund transactions.", "title": "Transaction Date and Time Stamps", "properties": { "create_time": { "description": "The date and time when the transaction occurred, in [Internet date and time format](https://tools.ietf.org/html/rfc3339#section-5.6).", "readOnly": true, "$ref": "#/components/schemas/date_time" }, "update_time": { "description": "The date and time when the transaction was last updated, in [Internet date and time format](https://tools.ietf.org/html/rfc3339#section-5.6).", "readOnly": true, "$ref": "#/components/schemas/date_time" } } }, "amount_breakdown": { "type": "object", "description": "The breakdown of the amount. Breakdown provides details such as total item amount, total tax amount, shipping, handling, insurance, and discounts, if any.", "title": "Amount Breakdown", "properties": { "item_total": { "description": "The subtotal for all items. Required if the request includes `purchase_units[].items[].unit_amount`. Must equal the sum of `(items[].unit_amount * items[].quantity)` for all items. item_total.value can not be a negative number.", "$ref": "#/components/schemas/money" }, "shipping": { "description": "The shipping fee for all items within a given `purchase_unit`. shipping.value can not be a negative number.", "$ref": "#/components/schemas/money" }, "handling": { "description": "The handling fee for all items within a given `purchase_unit`. handling.value can not be a negative number.", "$ref": "#/components/schemas/money" }, "tax_total": { "description": "The total tax for all items. Required if the request includes `purchase_units.items.tax`. Must equal the sum of `(items[].tax * items[].quantity)` for all items. tax_total.value can not be a negative number.", "$ref": "#/components/schemas/money" }, "insurance": { "description": "The insurance fee for all items within a given `purchase_unit`. insurance.value can not be a negative number.", "$ref": "#/components/schemas/money" }, "shipping_discount": { "description": "The shipping discount for all items within a given `purchase_unit`. shipping_discount.value can not be a negative number.", "$ref": "#/components/schemas/money" }, "discount": { "description": "The discount for all items within a given `purchase_unit`. discount.value can not be a negative number.", "$ref": "#/components/schemas/money" } } }, "amount_with_breakdown": { "type": "object", "title": "Amount with Breakdown", "description": "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.", "allOf": [ { "$ref": "#/components/schemas/money" }, { "properties": { "breakdown": { "$ref": "#/components/schemas/amount_breakdown" } } } ] }, "apple_pay": { "type": "object", "title": "ApplePay payment response object", "description": "Information needed to pay using ApplePay.", "properties": { "id": { "description": "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.", "type": "string", "minLength": 1, "maxLength": 250, "pattern": "^.*$" }, "token": { "description": "Encrypted ApplePay token, containing card information. This token would be base64encoded. The pattern is defined by an external party and supports Unicode.", "type": "string", "minLength": 1, "maxLength": 10000, "pattern": "^.*$" }, "name": { "description": "Name on the wallet.", "$ref": "#/components/schemas/full_name" }, "email_address": { "description": "The email address of the account holder associated with this payment method.", "$ref": "#/components/schemas/email_address" }, "phone_number": { "description": "The phone number, in its canonical international [E.164 numbering plan format](https://www.itu.int/rec/T-REC-E.164/en).", "type": "object", "title": "Phone", "properties": { "national_number": { "type": "string", "description": "The national number, in its canonical international [E.164 numbering plan format](https://www.itu.int/rec/T-REC-E.164/en). 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).", "minLength": 1, "maxLength": 14, "pattern": "^[0-9]{1,14}?$" } }, "required": ["national_number"] }, "card": { "description": "The payment card information.", "$ref": "#/components/schemas/apple_pay_card_response" }, "attributes": { "description": "Additional attributes associated with apple pay.", "$ref": "#/components/schemas/apple_pay_attributes_response" }, "stored_credential": { "$ref": "#/components/schemas/card_stored_credential" } } }, "apple_pay_attributes": { "type": "object", "title": "Apple Pay Attributes", "description": "Additional attributes associated with apple pay.", "properties": { "customer": { "$ref": "#/components/schemas/customer" }, "vault": { "$ref": "#/components/schemas/v3_vault_instruction_base" } } }, "apple_pay_attributes_response": { "type": "object", "title": "Apple Pay Attributes Response", "description": "Additional attributes associated with the use of Apple Pay.", "properties": { "vault": { "$ref": "#/components/schemas/vault_response" } } }, "apple_pay_card_response": { "type": "object", "title": "Apple Pay Card Response", "description": "The Card from Apple Pay Wallet used to fund the payment.", "properties": { "name": { "type": "string", "description": "The card holder's name as it appears on the card.", "minLength": 2, "maxLength": 300 }, "last_digits": { "type": "string", "description": "The last digits of the payment card.", "pattern": "[0-9]{2,}", "readOnly": true }, "brand": { "description": "The card brand or network. Typically used in the response.", "readOnly": true, "$ref": "#/components/schemas/card_brand" }, "available_networks": { "$ref": "#/components/schemas/card_brand_list" }, "type": { "description": "The payment card type.", "$ref": "#/components/schemas/card_type" }, "authentication_result": { "$ref": "#/components/schemas/authentication_response" }, "attributes": { "$ref": "#/components/schemas/card_attributes_response" }, "from_request": { "$ref": "#/components/schemas/card_from_request" }, "expiry": { "description": "The card expiration year and month, in [Internet date format](https://tools.ietf.org/html/rfc3339#section-5.6).", "$ref": "#/components/schemas/date_year_month" }, "bin_details": { "description": "Bank Identification Number (BIN) details used to fund a payment.", "$ref": "#/components/schemas/bin_details" }, "stored_credential": { "$ref": "#/components/schemas/card_stored_credential" }, "billing_address": { "description": "The portable international postal address. Maps to [AddressValidationMetadata](https://github.com/googlei18n/libaddressinput/wiki/AddressValidationMetadata) and HTML 5.1 [Autofilling form controls: the autocomplete attribute](https://www.w3.org/TR/html51/sec-forms.html#autofilling-form-controls-the-autocomplete-attribute).", "type": "object", "title": "Portable Postal Address (Medium-Grained)", "properties": { "address_line_1": { "type": "string", "description": "The first line of the address, such as number and street, for example, `173 Drury Lane`. Needed for data entry, and Compliance and Risk checks. This field needs to pass the full address.", "maxLength": 300 }, "address_line_2": { "type": "string", "description": "The second line of the address, for example, a suite or apartment number.", "maxLength": 300 }, "admin_area_2": { "type": "string", "description": "A city, town, or village. Smaller than `admin_area_level_1`.", "maxLength": 120 }, "admin_area_1": { "type": "string", "description": "The highest-level sub-division in a country, which is usually a province, state, or ISO-3166-2 subdivision. This data is formatted for postal delivery, for example, `CA` and not `California`. Value, by country, is:", "maxLength": 300 }, "postal_code": { "type": "string", "description": "The postal code, which is the ZIP code or equivalent. Typically required for countries with a postal code or an equivalent. See [postal code](https://en.wikipedia.org/wiki/Postal_code).", "maxLength": 60 }, "country_code": { "$ref": "#/components/schemas/country_code" } }, "required": ["country_code"] }, "country_code": { "$ref": "#/components/schemas/country_code-2", "description": "The country where the card is issued." } } }, "apple_pay_decrypted_token_data": { "type": "object", "title": "ApplePay Decrypted Token Data", "description": "Information about the Payment data obtained by decrypting Apple Pay token.", "properties": { "transaction_amount": { "description": "The transaction amount for the payment that the payer has approved on apple platform.", "$ref": "#/components/schemas/money" }, "tokenized_card": { "description": "The payment card to use to fund a payment. Can be a credit or debit card.", "type": "object", "title": "Card", "properties": { "name": { "type": "string", "description": "The card holder's name as it appears on the card.", "maxLength": 300, "minLength": 1, "pattern": "^.{1,300}$" }, "number": { "type": "string", "description": "The primary account number (PAN) for the payment card.", "pattern": "^[0-9]{13,19}$", "minLength": 13, "maxLength": 19 }, "expiry": { "description": "The card expiration year and month, in [Internet date format](https://tools.ietf.org/html/rfc3339#section-5.6) For example: 2028-04", "$ref": "#/components/schemas/date_year_month" }, "card_type": { "description": "The card brand or network. Typically used in the response.", "readOnly": true, "$ref": "#/components/schemas/card_brand", "deprecated": true }, "type": { "description": "The payment card type.", "$ref": "#/components/schemas/card_type" }, "brand": { "description": "The card brand or network. Typically used in the response.", "$ref": "#/components/schemas/card_brand" }, "billing_address": { "description": "The portable international postal address. Maps to [AddressValidationMetadata](https://github.com/googlei18n/libaddressinput/wiki/AddressValidationMetadata) and HTML 5.1 [Autofilling form controls: the autocomplete attribute](https://www.w3.org/TR/html51/sec-forms.html#autofilling-form-controls-the-autocomplete-attribute).", "type": "object", "title": "Portable Postal Address (Medium-Grained)", "properties": { "address_line_1": { "type": "string", "description": "The first line of the address, such as number and street, for example, `173 Drury Lane`. Needed for data entry, and Compliance and Risk checks. This field needs to pass the full address.", "maxLength": 300 }, "address_line_2": { "type": "string", "description": "The second line of the address, for example, a suite or apartment number.", "maxLength": 300 }, "admin_area_2": { "type": "string", "description": "A city, town, or village. Smaller than `admin_area_level_1`.", "maxLength": 120 }, "admin_area_1": { "type": "string", "description": "The highest-level sub-division in a country, which is usually a province, state, or ISO-3166-2 subdivision. This data is formatted for postal delivery, for example, `CA` and not `California`. Value, by country, is:", "maxLength": 300 }, "postal_code": { "type": "string", "description": "The postal code, which is the ZIP code or equivalent. Typically required for countries with a postal code or an equivalent. See [postal code](https://en.wikipedia.org/wiki/Postal_code).", "maxLength": 60 }, "country_code": { "$ref": "#/components/schemas/country_code" } }, "required": ["country_code"] } } }, "device_manufacturer_id": { "description": "Apple Pay Hex-encoded device manufacturer identifier. The pattern is defined by an external party and supports Unicode.", "type": "string", "minLength": 1, "maxLength": 2000, "pattern": "^.*$" }, "payment_data_type": { "description": "Indicates the type of payment data passed, in case of Non China the payment data is 3DSECURE and for China it is EMV.", "type": "string", "minLength": 1, "maxLength": 16, "pattern": "^[0-9A-Z_]+$", "x-enumDescriptions": [ { "value": "3DSECURE", "description": "The card was authenticated using 3D Secure (3DS) authentication scheme. While using this value make sure to populate cryptogram and eci_indicator as part of payment data.." }, { "value": "EMV", "description": "The card was authenticated using EMV method, which is applicable for China. While using this value make sure to pass emv_data and pin as part of payment data." } ], "enum": ["3DSECURE", "EMV"] }, "payment_data": { "description": "Apple Pay payment data object which contains the cryptogram, eci_indicator and other data.", "$ref": "#/components/schemas/apple_pay_payment_data" } }, "required": ["tokenized_card"] }, "apple_pay_experience_context": { "type": "object", "title": "Apple Pay Experience Context", "description": "Customizes the payer experience during the approval process for the payment.", "properties": { "return_url": { "description": "The URL where the customer is redirected after the customer approves the payment.", "format": "uri", "$ref": "#/components/schemas/url" }, "cancel_url": { "description": "The URL where the customer is redirected after the customer cancels the payment.", "format": "uri", "$ref": "#/components/schemas/url" } }, "required": ["return_url", "cancel_url"] }, "apple_pay_payment_data": { "type": "object", "title": "ApplePay Payment Data", "description": "Information about the decrypted apple pay payment data for the token like cryptogram, eci indicator.", "properties": { "cryptogram": { "description": "Online payment cryptogram, as defined by 3D Secure. The pattern is defined by an external party and supports Unicode.", "type": "string", "minLength": 1, "maxLength": 2000, "pattern": "^.*$" }, "eci_indicator": { "description": "ECI indicator, as defined by 3- Secure. The pattern is defined by an external party and supports Unicode.", "type": "string", "minLength": 1, "maxLength": 256, "pattern": "^.*$" }, "emv_data": { "description": "Encoded Apple Pay EMV Payment Structure used for payments in China. The pattern is defined by an external party and supports Unicode.", "type": "string", "minLength": 1, "maxLength": 2000, "pattern": "^.*$" }, "pin": { "description": "Bank Key encrypted Apple Pay PIN. The pattern is defined by an external party and supports Unicode.", "type": "string", "minLength": 1, "maxLength": 2000, "pattern": "^.*$" } } }, "apple_pay_request": { "type": "object", "title": "ApplePay payment request object", "description": "Information needed to pay using ApplePay.", "properties": { "id": { "description": "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.", "type": "string", "minLength": 1, "maxLength": 250, "pattern": "^.*$" }, "name": { "description": "Name on the account holder associated with apple pay.", "$ref": "#/components/schemas/full_name" }, "email_address": { "description": "The email address of the account holder associated with apple pay.", "$ref": "#/components/schemas/email_address" }, "phone_number": { "description": "The phone number, in its canonical international [E.164 numbering plan format](https://www.itu.int/rec/T-REC-E.164/en).", "type": "object", "title": "Phone", "properties": { "national_number": { "type": "string", "description": "The national number, in its canonical international [E.164 numbering plan format](https://www.itu.int/rec/T-REC-E.164/en). 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).", "minLength": 1, "maxLength": 14, "pattern": "^[0-9]{1,14}?$" } }, "required": ["national_number"] }, "decrypted_token": { "description": "The decrypted payload details for the apple pay token.", "$ref": "#/components/schemas/apple_pay_decrypted_token_data" }, "stored_credential": { "$ref": "#/components/schemas/card_stored_credential" }, "vault_id": { "description": "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.", "$ref": "#/components/schemas/vault_id" }, "attributes": { "$ref": "#/components/schemas/apple_pay_attributes" }, "experience_context": { "$ref": "#/components/schemas/apple_pay_experience_context" } } }, "assurance_details": { "type": "object", "title": "Assurance Details", "description": "Information about cardholder possession validation and cardholder identification and verifications (ID&V).", "properties": { "account_verified": { "description": "If true, indicates that Cardholder possession validation has been performed on returned payment credential.", "type": "boolean", "default": false }, "card_holder_authenticated": { "description": "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.", "type": "boolean", "default": false } } }, "authentication_response": { "type": "object", "title": "Authentication Response", "description": "Results of Authentication such as 3D Secure.", "properties": { "liability_shift": { "$ref": "#/components/schemas/liability_shift" }, "three_d_secure": { "$ref": "#/components/schemas/three_d_secure_authentication_response" } } }, "authorization": { "type": "object", "title": "Authorization", "description": "The authorized payment transaction.", "allOf": [ { "$ref": "#/components/schemas/authorization_status" }, { "properties": { "id": { "description": "The PayPal-generated ID for the authorized payment.", "type": "string", "readOnly": true }, "amount": { "description": "The amount for this authorized payment.", "$ref": "#/components/schemas/money", "readOnly": true }, "invoice_id": { "description": "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.", "type": "string", "readOnly": true }, "custom_id": { "type": "string", "description": "The API caller-provided external ID. Used to reconcile API caller-initiated transactions with PayPal transactions. Appears in transaction and settlement reports.", "maxLength": 255 }, "network_transaction_reference": { "$ref": "#/components/schemas/network_transaction" }, "seller_protection": { "$ref": "#/components/schemas/seller_protection", "readOnly": true }, "expiration_time": { "description": "The date and time when the authorized payment expires, in [Internet date and time format](https://tools.ietf.org/html/rfc3339#section-5.6).", "$ref": "#/components/schemas/date_time", "readOnly": true }, "links": { "$ref": "#/components/schemas/authorization_definitions-link_description_list" } } }, { "$ref": "#/components/schemas/activity_timestamps" } ] }, "authorization_definitions-link_description_list": { "description": "An array of related [HATEOAS links](/docs/api/reference/api-responses/#hateoas-links).", "type": "array", "readOnly": true, "items": { "$ref": "#/components/schemas/link_description" } }, "authorization_status": { "type": "object", "title": "Authorization Status With Details", "description": "The status fields and status details for an authorized payment.", "properties": { "status": { "title": "Authorization Status", "description": "The status for the authorized payment.", "type": "string", "readOnly": true, "x-enumDescriptions": [ { "value": "CREATED", "description": "The authorized payment is created. No captured payments have been made for this authorized payment." }, { "value": "CAPTURED", "description": "The authorized payment has one or more captures against it. The sum of these captured payments is greater than the amount of the original authorized payment." }, { "value": "DENIED", "description": "PayPal cannot authorize funds for this authorized payment." }, { "value": "PARTIALLY_CAPTURED", "description": "A captured payment was made for the authorized payment for an amount that is less than the amount of the original authorized payment." }, { "value": "VOIDED", "description": "The authorized payment was voided. No more captured payments can be made against this authorized payment." }, { "value": "PENDING", "description": "The created authorization is in pending state. For more information, see status.details." } ], "enum": [ "CREATED", "CAPTURED", "DENIED", "PARTIALLY_CAPTURED", "VOIDED", "PENDING" ] }, "status_details": { "description": "The details of the authorized order pending status.", "readOnly": true, "$ref": "#/components/schemas/authorization_status_details" } } }, "authorization_status_details": { "title": "Authorization Status Details", "description": "The details of the authorized payment status.", "type": "object", "properties": { "reason": { "title": "Authorization Incomplete Reason", "description": "The reason why the authorized status is `PENDING`.", "type": "string", "minLength": 1, "maxLength": 64, "pattern": "^[A-Z_]+$", "x-enumDescriptions": [ { "value": "PENDING_REVIEW", "description": "Authorization is pending manual review." }, { "value": "DECLINED_BY_RISK_FRAUD_FILTERS", "description": "Risk Filter set by the payee failed for the transaction." } ], "enum": ["PENDING_REVIEW", "DECLINED_BY_RISK_FRAUD_FILTERS"] } } }, "authorization_with_additional_data": { "type": "object", "title": "Authorization with Additional Data", "description": "The authorization with additional payment details, such as risk assessment and processor response. These details are populated only for certain payment methods.", "allOf": [ { "$ref": "#/components/schemas/authorization" }, { "properties": { "processor_response": { "$ref": "#/components/schemas/processor_response", "description": "The processor response for card transactions.", "readOnly": true } } } ] }, "authorization_with_additional_data_list": { "type": "array", "description": "An array of authorized payments for a purchase unit. A purchase unit can have zero or more authorized payments.", "items": { "$ref": "#/components/schemas/authorization_with_additional_data" } }, "bancontact": { "type": "object", "title": "Bancontact payment object", "description": "Information used to pay Bancontact.", "properties": { "name": { "description": "The name of the account holder associated with this payment method.", "$ref": "#/components/schemas/full_name" }, "country_code": { "description": "The two-character ISO 3166-1 country code.", "$ref": "#/components/schemas/country_code-2" }, "bic": { "description": "The bank identification code (BIC).", "$ref": "#/components/schemas/bic" }, "iban_last_chars": { "$ref": "#/components/schemas/iban_last_chars" }, "card_last_digits": { "type": "string", "minLength": 4, "maxLength": 4, "pattern": "[0-9]{4}", "description": "The last digits of the card used to fund the Bancontact payment." } } }, "bancontact_request": { "type": "object", "title": "Bancontact payment request", "description": "Information needed to pay using Bancontact.", "properties": { "name": { "description": "The name of the account holder associated with this payment method.", "$ref": "#/components/schemas/full_name" }, "country_code": { "description": "The two-character ISO 3166-1 country code.", "$ref": "#/components/schemas/country_code-2" }, "experience_context": { "description": "Customizes the payer experience during the approval process for the payment.", "$ref": "#/components/schemas/experience_context_base" } }, "required": ["name", "country_code"] }, "bic": { "type": "string", "title": "BIC", "description": "The business identification code (BIC). In payments systems, a BIC is used to identify a specific business, most commonly a bank.", "minLength": 8, "maxLength": 11, "pattern": "^[A-Z-a-z0-9]{4}[A-Z-a-z]{2}[A-Z-a-z0-9]{2}([A-Z-a-z0-9]{3})?$" }, "billing_agreement_id": { "type": "string", "description": "The PayPal billing agreement ID. References an approved recurring payment for goods or services.", "minLength": 2, "maxLength": 128, "pattern": "^[a-zA-Z0-9-]+$" }, "billing_cycle": { "title": "Billing Cycle", "description": "The billing cycle providing details of the billing frequency, amount, duration and if the billing cycle is a free, discounted or regular billing cycle. The sequence of the billing cycle will be in the following order - free trial billing cycle(s), discounted trial billing cycle(s), regular billing cycle(s).", "type": "object", "properties": { "tenure_type": { "type": "string", "description": "The tenure type of the billing cycle identifies if the billing cycle is a trial(free or discounted) or regular billing cycle.", "minLength": 1, "maxLength": 24, "pattern": "^[A-Z_]+$", "x-enumDescriptions": [ { "value": "REGULAR", "description": "A regular billing cycle to identify recurring charges for the billing agreement." }, { "value": "TRIAL", "description": "A trial billing cycle to identify free or discounted charge for the billing agreement. Free trails will not have a price object in pricing scheme where as a discounted trial would have a discounted price compared to regular billing cycle." } ], "enum": ["REGULAR", "TRIAL"] }, "pricing_scheme": { "description": "The active pricing scheme for this billing cycle. A free trial billing cycle does not require a pricing scheme.", "$ref": "#/components/schemas/pricing_scheme" }, "frequency": { "description": "The frequency details for this billing cycle.", "$ref": "#/components/schemas/frequency" }, "total_cycles": { "type": "integer", "description": "The number of times this billing cycle gets executed. Trial billing cycles can only be executed a finite number of times (value between 1 and 999 for total_cycles). Regular billing cycles can be executed infinite times (value of 0 for total_cycles) or a finite number of times (value between 1 and 999 for total_cycles).", "minimum": 0, "maximum": 999, "default": 1, "format": "int32" }, "sequence": { "type": "integer", "description": "The order in which this cycle is to run among other billing cycles. For example, a trial billing cycle has a `sequence` of `1` while a regular billing cycle has a `sequence` of `2`, so that trial cycle runs before the regular cycle.", "minimum": 1, "maximum": 3, "default": 1, "format": "int32" }, "start_date": { "description": "The start date for the billing cycle, in YYYY-MM-DD. This field should be not be provided if the billing cycle starts at the time of checkout. When this field is not provided, the billing cycle amount will be included in any data validations confirming that the total provided by the merchant match the sum of individual items due at the time of checkout. Only one billing cycle (with sequence equal to 1) can have a no start date.", "$ref": "#/components/schemas/date_no_time" } }, "required": ["tenure_type"] }, "billing_cycle_list": { "type": "array", "description": "An array of billing cycles for trial billing and regular billing. A plan can have at most two trial cycles and only one regular cycle.", "minItems": 1, "maxItems": 3, "items": { "$ref": "#/components/schemas/billing_cycle" } }, "bin_details": { "type": "object", "title": "Bin Details", "description": "Bank Identification Number (BIN) details used to fund a payment.", "properties": { "bin": { "type": "string", "description": "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.", "pattern": "^[0-9]+$", "maxLength": 25, "minLength": 1 }, "issuing_bank": { "type": "string", "description": "The issuer of the card instrument.", "minLength": 1, "maxLength": 64 }, "bin_country_code": { "description": "The [two-character ISO-3166-1 country code](/docs/integration/direct/rest/country-codes/) of the bank.", "$ref": "#/components/schemas/country_code-2" }, "products": { "$ref": "#/components/schemas/products_list" } } }, "blik": { "type": "object", "title": "BLIK payment object", "description": "Information used to pay using BLIK.", "properties": { "name": { "description": "The name of the account holder associated with this payment method.", "$ref": "#/components/schemas/full_name" }, "country_code": { "description": "The two-character ISO 3166-1 country code.", "$ref": "#/components/schemas/country_code-2" }, "email": { "description": "The email address of the account holder associated with this payment method.", "$ref": "#/components/schemas/email_address" }, "one_click": { "description": "The one-click integration flow object.", "$ref": "#/components/schemas/blik_one_click_response" } } }, "blik_experience_context": { "type": "object", "title": "BLIK Experience Context", "description": "Customizes the payer experience during the approval process for the BLIK payment.", "allOf": [ { "$ref": "#/components/schemas/experience_context_base" }, { "properties": { "consumer_ip": { "description": "The IP address of the consumer. It could be either IPv4 or IPv6.", "$ref": "#/components/schemas/ip_address" }, "consumer_user_agent": { "type": "string", "description": "The payer's User Agent. For example, Mozilla/5.0 (Macintosh; Intel Mac OS X x.y; rv:42.0).", "minLength": 1, "maxLength": 256, "pattern": "^.*$" } } } ] }, "blik_one_click": { "type": "object", "title": "BLIK one-click payment request", "description": "Information used to pay using BLIK one-click flow.", "properties": { "auth_code": { "type": "string", "description": "The 6-digit code used to authenticate a consumer within BLIK.", "minLength": 6, "maxLength": 6, "pattern": "^[0-9]{6}$" }, "consumer_reference": { "type": "string", "description": "The merchant generated, unique reference serving as a primary identifier for accounts connected between Blik and a merchant.", "minLength": 3, "maxLength": 64, "pattern": "^[ -~]{3,64}$" }, "alias_label": { "type": "string", "description": "A bank defined identifier used as a display name to allow the payer to differentiate between multiple registered bank accounts.", "minLength": 8, "maxLength": 35, "pattern": "^[ -~]{8,35}$" }, "alias_key": { "type": "string", "description": "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.", "minLength": 1, "maxLength": 19, "pattern": "^[0-9]+$" } }, "required": ["consumer_reference"] }, "blik_one_click_response": { "type": "object", "title": "BLIK one-click payment object", "description": "Information used to pay using BLIK one-click flow.", "properties": { "consumer_reference": { "type": "string", "description": "The merchant generated, unique reference serving as a primary identifier for accounts connected between Blik and a merchant.", "minLength": 3, "maxLength": 64, "pattern": "^[ -~]{3,64}$" } } }, "blik_request": { "type": "object", "title": "BLIK payment request", "description": "Information needed to pay using BLIK.", "properties": { "name": { "description": "The name of the account holder associated with this payment method.", "$ref": "#/components/schemas/full_name" }, "country_code": { "description": "The two-character ISO 3166-1 country code.", "$ref": "#/components/schemas/country_code-2" }, "email": { "description": "The email address of the account holder associated with this payment method.", "$ref": "#/components/schemas/email_address" }, "experience_context": { "description": "Customizes the payer experience during the approval process for the payment.", "$ref": "#/components/schemas/blik_experience_context" }, "level_0": { "description": "The level_0 integration flow object.", "$ref": "#/components/schemas/blik_seamless" }, "one_click": { "description": "The one-click integration flow object.", "$ref": "#/components/schemas/blik_one_click" } }, "required": ["name", "country_code"] }, "blik_seamless": { "type": "object", "title": "BLIK level_0 payment object", "description": "Information used to pay using BLIK level_0 flow.", "properties": { "auth_code": { "type": "string", "description": "The 6-digit code used to authenticate a consumer within BLIK.", "minLength": 6, "maxLength": 6, "pattern": "^[0-9]{6}$" } }, "required": ["auth_code"] }, "callback_configuration": { "type": "object", "title": "CallBack Configuration that the merchant can provide to PayPal/Venmo.", "description": "CallBack Configuration that the merchant can provide to PayPal/Venmo.", "properties": { "callback_events": { "$ref": "#/components/schemas/callback_events_list" }, "callback_url": { "type": "string", "description": "Merchant provided CallBack url.PayPal/Venmo will use this url to call the merchant back when the events occur .PayPal/Venmo expects a secured url usually in the https format.merchant can append the cart id or other params part of the url as query or path params.", "minLength": 10, "maxLength": 2040, "pattern": "^.*$", "format": "uri" } }, "required": ["callback_events", "callback_url"] }, "callback_events": { "type": "string", "minLength": 1, "maxLength": 256, "pattern": "^[0-9A-Z_]+$", "description": "CallBack event.", "x-enumDescriptions": [ { "value": "SHIPPING_ADDRESS", "description": "When Buyer changes or selects the shipping address on the PayPal/Venmo buyer approval flow , PayPal/Venmo will call merchant with the callback URL to update order totals." }, { "value": "SHIPPING_OPTIONS", "description": "When Buyer changes or selects the shipping options on the PayPal/Venmo buyer approval flow , PayPal/Venmo will call merchant with the callback URL to update order totals." } ], "enum": ["SHIPPING_ADDRESS", "SHIPPING_OPTIONS"] }, "callback_events_list": { "type": "array", "description": "An array of callback events merchant can subscribe to for the corresponding callback url.", "minItems": 1, "maxItems": 5, "uniqueItems": true, "items": { "$ref": "#/components/schemas/callback_events" } }, "capture": { "type": "object", "title": "Capture", "description": "A captured payment.", "allOf": [ { "$ref": "#/components/schemas/capture_status" }, { "properties": { "id": { "description": "The PayPal-generated ID for the captured payment.", "type": "string", "readOnly": true }, "amount": { "description": "The amount for this captured payment.", "$ref": "#/components/schemas/money", "readOnly": true }, "invoice_id": { "description": "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.", "type": "string", "readOnly": true }, "custom_id": { "type": "string", "description": "The API caller-provided external ID. Used to reconcile API caller-initiated transactions with PayPal transactions. Appears in transaction and settlement reports.", "maxLength": 255 }, "network_transaction_reference": { "$ref": "#/components/schemas/network_transaction" }, "seller_protection": { "$ref": "#/components/schemas/seller_protection", "readOnly": true }, "final_capture": { "description": "Indicates whether you can make additional captures against the authorized payment. Set to `true` if you do not intend to capture additional payments against the authorization. Set to `false` if you intend to capture additional payments against the authorization.", "type": "boolean", "default": false, "readOnly": true }, "seller_receivable_breakdown": { "$ref": "#/components/schemas/seller_receivable_breakdown", "readOnly": true }, "disbursement_mode": { "$ref": "#/components/schemas/disbursement_mode" }, "links": { "$ref": "#/components/schemas/capture_definitions-link_description_list" }, "processor_response": { "description": "An object that provides additional processor information for a direct credit card transaction.", "$ref": "#/components/schemas/processor_response" } } }, { "$ref": "#/components/schemas/activity_timestamps" } ] }, "capture_definitions-link_description_list": { "description": "An array of related [HATEOAS links](/docs/api/reference/api-responses/#hateoas-links).", "type": "array", "readOnly": true, "items": { "$ref": "#/components/schemas/link_description" } }, "capture_list": { "type": "array", "description": "An array of captured payments for a purchase unit. A purchase unit can have zero or more captured payments.", "items": { "$ref": "#/components/schemas/capture" } }, "capture_status": { "type": "object", "title": "Capture Status With Details", "description": "The status and status details of a captured payment.", "properties": { "status": { "title": "Capture Status", "description": "The status of the captured payment.", "type": "string", "x-enumDescriptions": [ { "value": "COMPLETED", "description": "The funds for this captured payment were credited to the payee's PayPal account." }, { "value": "DECLINED", "description": "The funds could not be captured." }, { "value": "PARTIALLY_REFUNDED", "description": "An amount less than this captured payment's amount was partially refunded to the payer." }, { "value": "PENDING", "description": "The funds for this captured payment was not yet credited to the payee's PayPal account. For more information, see status.details." }, { "value": "REFUNDED", "description": "An amount greater than or equal to this captured payment's amount was refunded to the payer." }, { "value": "FAILED", "description": "There was an error while capturing payment." } ], "readOnly": true, "enum": [ "COMPLETED", "DECLINED", "PARTIALLY_REFUNDED", "PENDING", "REFUNDED", "FAILED" ] }, "status_details": { "description": "The details of the captured payment status.", "readOnly": true, "$ref": "#/components/schemas/capture_status_details" } } }, "capture_status_details": { "title": "Capture Status Details", "description": "The details of the captured payment status.", "type": "object", "properties": { "reason": { "title": "Capture Incomplete Reason", "description": "The reason why the captured payment status is `PENDING` or `DENIED`.", "type": "string", "minLength": 1, "maxLength": 64, "pattern": "^[A-Z_]+$", "x-enumDescriptions": [ { "value": "BUYER_COMPLAINT", "description": "The payer initiated a dispute for this captured payment with PayPal." }, { "value": "CHARGEBACK", "description": "The captured funds were reversed in response to the payer disputing this captured payment with the issuer of the financial instrument used to pay for this captured payment." }, { "value": "ECHECK", "description": "The payer paid by an eCheck that has not yet cleared." }, { "value": "INTERNATIONAL_WITHDRAWAL", "description": "Visit your online account. In your **Account Overview**, accept and deny this payment." }, { "value": "OTHER", "description": "No additional specific reason can be provided. For more information about this captured payment, visit your account online or contact PayPal." }, { "value": "PENDING_REVIEW", "description": "The captured payment is pending manual review." }, { "value": "RECEIVING_PREFERENCE_MANDATES_MANUAL_ACTION", "description": "The payee has not yet set up appropriate receiving preferences for their account. For more information about how to accept or deny this payment, visit your account online. This reason is typically offered in scenarios such as when the currency of the captured payment is different from the primary holding currency of the payee." }, { "value": "REFUNDED", "description": "The captured funds were refunded." }, { "value": "TRANSACTION_APPROVED_AWAITING_FUNDING", "description": "The payer must send the funds for this captured payment. This code generally appears for manual EFTs." }, { "value": "UNILATERAL", "description": "The payee does not have a PayPal account." }, { "value": "VERIFICATION_REQUIRED", "description": "The payee's PayPal account is not verified." }, { "value": "DECLINED_BY_RISK_FRAUD_FILTERS", "description": "Risk Filter set by the payee failed for the transaction." } ], "enum": [ "BUYER_COMPLAINT", "CHARGEBACK", "ECHECK", "INTERNATIONAL_WITHDRAWAL", "OTHER", "PENDING_REVIEW", "RECEIVING_PREFERENCE_MANDATES_MANUAL_ACTION", "REFUNDED", "TRANSACTION_APPROVED_AWAITING_FUNDING", "UNILATERAL", "VERIFICATION_REQUIRED", "DECLINED_BY_RISK_FRAUD_FILTERS" ] } } }, "card_attributes": { "type": "object", "title": "Card Attributes", "description": "Additional attributes associated with the use of this card.", "properties": { "customer": { "$ref": "#/components/schemas/card_customer" }, "vault": { "description": "Instruction to vault the card based on the specified strategy.", "$ref": "#/components/schemas/vault_instruction_base" }, "verification": { "description": "Instruction to optionally verify the card based on the specified strategy.", "$ref": "#/components/schemas/card_verification" } } }, "card_attributes_response": { "type": "object", "title": "Card Attributes Response", "description": "Additional attributes associated with the use of this card.", "properties": { "vault": { "$ref": "#/components/schemas/card_vault_response" } } }, "card_brand": { "type": "string", "title": "Card Brand", "description": "The card network or brand. Applies to credit, debit, gift, and payment cards.", "minLength": 1, "maxLength": 255, "pattern": "^[A-Z_]+$", "x-enumDescriptions": [ { "value": "VISA", "description": "Visa card." }, { "value": "MASTERCARD", "description": "Mastercard card." }, { "value": "DISCOVER", "description": "Discover card." }, { "value": "AMEX", "description": "American Express card." }, { "value": "SOLO", "description": "Solo debit card." }, { "value": "JCB", "description": "Japan Credit Bureau card." }, { "value": "STAR", "description": "Military Star card." }, { "value": "DELTA", "description": "Delta Airlines card." }, { "value": "SWITCH", "description": "Switch credit card." }, { "value": "MAESTRO", "description": "Maestro credit card." }, { "value": "CB_NATIONALE", "description": "Carte Bancaire (CB) credit card." }, { "value": "CONFIGOGA", "description": "Configoga credit card." }, { "value": "CONFIDIS", "description": "Confidis credit card." }, { "value": "ELECTRON", "description": "Visa Electron credit card." }, { "value": "CETELEM", "description": "Cetelem credit card." }, { "value": "CHINA_UNION_PAY", "description": "China union pay credit card." }, { "value": "DINERS", "description": "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." }, { "value": "ELO", "description": "The Brazilian Elo card payment network." }, { "value": "HIPER", "description": "The Hiper - Ingenico ePayment network." }, { "value": "HIPERCARD", "description": "The Brazilian Hipercard payment network that's widely accepted in the retail market." }, { "value": "RUPAY", "description": "The RuPay payment network." }, { "value": "GE", "description": "The GE Credit Union 3Point card payment network." }, { "value": "SYNCHRONY", "description": "The Synchrony Financial (SYF) payment network." }, { "value": "EFTPOS", "description": "The Electronic Fund Transfer At Point of Sale(EFTPOS) Debit card payment network." }, { "value": "CARTE_BANCAIRE", "description": "The Carte Bancaire payment network." }, { "value": "STAR_ACCESS", "description": "The Star Access payment network." }, { "value": "PULSE", "description": "The Pulse payment network." }, { "value": "NYCE", "description": "The NYCE payment network." }, { "value": "ACCEL", "description": "The Accel payment network." }, { "value": "UNKNOWN", "description": "UNKNOWN payment network." } ], "enum": [ "VISA", "MASTERCARD", "DISCOVER", "AMEX", "SOLO", "JCB", "STAR", "DELTA", "SWITCH", "MAESTRO", "CB_NATIONALE", "CONFIGOGA", "CONFIDIS", "ELECTRON", "CETELEM", "CHINA_UNION_PAY", "DINERS", "ELO", "HIPER", "HIPERCARD", "RUPAY", "GE", "SYNCHRONY", "EFTPOS", "CARTE_BANCAIRE", "STAR_ACCESS", "PULSE", "NYCE", "ACCEL", "UNKNOWN" ] }, "card_brand_list": { "type": "array", "description": "Array of brands or networks associated with the card.", "readOnly": true, "minItems": 1, "maxItems": 256, "items": { "$ref": "#/components/schemas/card_brand" } }, "card_customer": { "type": "object", "title": "Card Customer Information", "description": "The details about a customer in PayPal's system of record.", "allOf": [ { "$ref": "#/components/schemas/customer" }, { "properties": { "merchant_customer_id": { "description": "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.", "type": "string", "minLength": 1, "maxLength": 64, "pattern": "^[0-9a-zA-Z-_.^*$@#]+$" } } } ] }, "card_experience_context": { "type": "object", "title": "Card Experience Context", "description": "Customizes the payer experience during the 3DS Approval for payment.", "properties": { "return_url": { "description": "The URL where the customer will be redirected upon successfully completing the 3DS challenge.", "type": "string", "minLength": 10, "maxLength": 4000, "format": "uri", "$ref": "#/components/schemas/url" }, "cancel_url": { "description": "The URL where the customer will be redirected upon cancelling the 3DS challenge.", "type": "string", "minLength": 10, "maxLength": 4000, "format": "uri", "$ref": "#/components/schemas/url" } } }, "card_from_request": { "type": "object", "title": "Card from Request", "description": "Representation of card details as received in the request.", "properties": { "expiry": { "description": "The card expiration year and month, in [Internet date format](https://tools.ietf.org/html/rfc3339#section-5.6).", "$ref": "#/components/schemas/date_year_month" }, "last_digits": { "type": "string", "description": "The last digits of the payment card.", "pattern": "[0-9]{2,}", "minLength": 2, "maxLength": 4, "readOnly": true } } }, "card_request": { "type": "object", "title": "Card Request", "description": "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*.
", "properties": { "name": { "type": "string", "description": "The card holder's name as it appears on the card.", "maxLength": 300, "minLength": 1, "pattern": "^.{1,300}$" }, "number": { "type": "string", "description": "The primary account number (PAN) for the payment card.", "pattern": "^[0-9]{13,19}$", "minLength": 13, "maxLength": 19 }, "expiry": { "description": "The card expiration year and month, in [Internet date format](https://tools.ietf.org/html/rfc3339#section-5.6) For example: 2028-04", "$ref": "#/components/schemas/date_year_month" }, "security_code": { "type": "string", "description": "The three- or four-digit security code of the card. Also known as the CVV, CVC, CVN, CVE, or CID. This parameter cannot be present in the request when `payment_initiator=MERCHANT`.", "pattern": "^[0-9]{3,4}$", "minLength": 3, "maxLength": 4 }, "billing_address": { "description": "The portable international postal address. Maps to [AddressValidationMetadata](https://github.com/googlei18n/libaddressinput/wiki/AddressValidationMetadata) and HTML 5.1 [Autofilling form controls: the autocomplete attribute](https://www.w3.org/TR/html51/sec-forms.html#autofilling-form-controls-the-autocomplete-attribute).", "type": "object", "title": "Portable Postal Address (Medium-Grained)", "properties": { "address_line_1": { "type": "string", "description": "The first line of the address, such as number and street, for example, `173 Drury Lane`. Needed for data entry, and Compliance and Risk checks. This field needs to pass the full address.", "maxLength": 300 }, "address_line_2": { "type": "string", "description": "The second line of the address, for example, a suite or apartment number.", "maxLength": 300 }, "admin_area_2": { "type": "string", "description": "A city, town, or village. Smaller than `admin_area_level_1`.", "maxLength": 120 }, "admin_area_1": { "type": "string", "description": "The highest-level sub-division in a country, which is usually a province, state, or ISO-3166-2 subdivision. This data is formatted for postal delivery, for example, `CA` and not `California`. Value, by country, is:", "maxLength": 300 }, "postal_code": { "type": "string", "description": "The postal code, which is the ZIP code or equivalent. Typically required for countries with a postal code or an equivalent. See [postal code](https://en.wikipedia.org/wiki/Postal_code).", "maxLength": 60 }, "country_code": { "$ref": "#/components/schemas/country_code" } }, "required": ["country_code"] }, "attributes": { "description": "Additional attributes associated with the use of this card.", "$ref": "#/components/schemas/card_attributes" }, "vault_id": { "description": "The PayPal-generated ID for the saved card payment source. Typically stored on the merchant's server.", "$ref": "#/components/schemas/vault_id" }, "single_use_token": { "description": "The PayPal-generated, short-lived, one-time-use token, used to communicate payment information to PayPal for transaction processing.", "$ref": "#/components/schemas/single_use_token" }, "stored_credential": { "$ref": "#/components/schemas/card_stored_credential" }, "network_token": { "description": "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.", "$ref": "#/components/schemas/network_token_request" }, "experience_context": { "$ref": "#/components/schemas/card_experience_context" } } }, "card_response": { "type": "object", "title": "Card Response", "description": "The payment card to use to fund a payment. Card can be a credit or debit card.", "properties": { "name": { "type": "string", "description": "The card holder's name as it appears on the card.", "minLength": 2, "maxLength": 300 }, "last_digits": { "type": "string", "description": "The last digits of the payment card.", "pattern": "[0-9]{2,}", "readOnly": true }, "brand": { "description": "The card brand or network. Typically used in the response.", "readOnly": true, "$ref": "#/components/schemas/card_brand" }, "available_networks": { "$ref": "#/components/schemas/card_brand_list" }, "type": { "description": "The payment card type.", "$ref": "#/components/schemas/card_type" }, "authentication_result": { "$ref": "#/components/schemas/authentication_response" }, "attributes": { "$ref": "#/components/schemas/card_attributes_response" }, "from_request": { "$ref": "#/components/schemas/card_from_request" }, "expiry": { "description": "The card expiration year and month, in [Internet date format](https://tools.ietf.org/html/rfc3339#section-5.6).", "$ref": "#/components/schemas/date_year_month" }, "bin_details": { "description": "Bank Identification Number (BIN) details used to fund a payment.", "$ref": "#/components/schemas/bin_details" }, "stored_credential": { "$ref": "#/components/schemas/card_stored_credential" } } }, "card_stored_credential": { "type": "object", "title": "Card Stored Credential", "description": "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:
", "properties": { "payment_initiator": { "$ref": "#/components/schemas/payment_initiator" }, "payment_type": { "$ref": "#/components/schemas/stored_payment_source_payment_type" }, "usage": { "$ref": "#/components/schemas/stored_payment_source_usage_type" }, "previous_network_transaction_reference": { "$ref": "#/components/schemas/network_transaction_reference" } }, "required": ["payment_initiator", "payment_type"] }, "card_supplementary_data": { "type": "object", "title": "Card Supplementary Data", "description": "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.", "properties": { "level_2": { "$ref": "#/components/schemas/level_2_card_processing_data" }, "level_3": { "$ref": "#/components/schemas/level_3_card_processing_data" } } }, "card_type": { "type": "string", "title": "Card Type", "description": "Type of card. i.e Credit, Debit and so on.", "minLength": 1, "maxLength": 255, "pattern": "^[A-Z_]+$", "x-enumDescriptions": [ { "value": "CREDIT", "description": "A credit card." }, { "value": "DEBIT", "description": "A debit card." }, { "value": "PREPAID", "description": "A Prepaid card." }, { "value": "STORE", "description": "A store card." }, { "value": "UNKNOWN", "description": "Card type cannot be determined." } ], "enum": ["CREDIT", "DEBIT", "PREPAID", "STORE", "UNKNOWN"] }, "card_vault_response": { "type": "object", "title": "Card Vault Response", "description": "The details about a saved Card payment source.", "properties": { "id": { "type": "string", "description": "The PayPal-generated ID for the saved payment source.", "minLength": 1, "maxLength": 255 }, "status": { "title": "Vault Status", "type": "string", "description": "The vault status.", "minLength": 1, "maxLength": 255, "pattern": "^[0-9A-Z_]+$", "x-enumDescriptions": [ { "value": "VAULTED", "description": "The payment source has been saved in your customer's vault. This vault status reflects `/v3/vault` status." }, { "value": "CREATED", "description": "DEPRECATED. The payment source has been saved in your customer's vault. This status applies to deprecated integration patterns and will not be returned for v3/vault integrations." }, { "value": "APPROVED", "description": "Customer has approved the action of saving the specified payment_source into their vault. Use v3/vault/payment-tokens with given setup_token to save the payment source in the vault" } ], "deprecated": true, "enum": ["VAULTED", "CREATED", "APPROVED"] }, "links": { "$ref": "#/components/schemas/link_description_list" }, "customer": { "$ref": "#/components/schemas/card_customer" } } }, "card_verification": { "type": "object", "title": "Card Verification", "description": "The API caller can opt in to verify the card through PayPal offered verification services (e.g. Smart Dollar Auth, 3DS).", "properties": { "method": { "description": "The method used for card verification.", "type": "string", "minLength": 1, "maxLength": 255, "pattern": "^[0-9A-Z_]+$", "default": "SCA_WHEN_REQUIRED", "x-enumDescriptions": [ { "value": "SCA_ALWAYS", "description": "Selecting this option will attempt to force a strong customer authentication for the authorization/transaction. In countries where SCA has been defined and implemented it will result in a contingency and HATEOAS link being returned. The API caller should redirect the payer to that link so that they can authenticate themselves against their issuing bank or other entity. As noted, the HATEOAS link is only available in all regions where strong authentication is supported, (e.g. in European countries where 3DS is live). Merchants can use this setting as an additional layer of security if they choose to. In all cases, when an authorization is requested the AVS/CVV results will be returned in the response." }, { "value": "SCA_WHEN_REQUIRED", "description": "This is the default. When an authorization or transaction is attempted this option will return a contingency and HATEOAS link only when local regulations require strong customer authentication, (e.g. 3DS in countries and use cases where it is mandated). The API caller should redirect the payer to the link so that they can authenticate themselves. In all cases, when an authorization is requested the AVS/CVV results will be returned in the response." }, { "value": "3D_SECURE", "description": "The contingency surfaced as an additional security layer that helps prevent unauthorized card-not-present transactions and protects the merchant from exposure to fraud.", "deprecated": true }, { "value": "AVS_CVV", "description": "Places a temporary hold on the card to ensure its validity. This process protects the merchant from exposure to fraud. This verification method will confirm that the address information or CVV included matches what the issuing bank has on file for the associated card, ensuring that only authorized card users are able to make purchases from you.", "deprecated": true } ], "enum": ["SCA_ALWAYS", "SCA_WHEN_REQUIRED", "3D_SECURE", "AVS_CVV"] } } }, "charge_pattern": { "type": "string", "description": "Expected business/pricing model for the billing agreement.", "minLength": 1, "maxLength": 30, "pattern": "^[A-Z0-9_]+$", "x-enumDescriptions": [ { "value": "IMMEDIATE", "description": "On-demand instant payments – non-recurring, pre-paid, variable amount, variable frequency." }, { "value": "DEFERRED", "description": "Pay after use, non-recurring post-paid, variable amount, irregular frequency." }, { "value": "RECURRING_PREPAID", "description": "Pay upfront fixed or variable amount on a fixed date before the goods/service is delivered." }, { "value": "RECURRING_POSTPAID", "description": "Pay on a fixed date based on usage or consumption after the goods/service is delivered." }, { "value": "THRESHOLD_PREPAID", "description": "Charge payer when the set amount is reached or monthly billing cycle, whichever comes first, before the goods/service is delivered." }, { "value": "THRESHOLD_POSTPAID", "description": "Charge payer when the set amount is reached or monthly billing cycle, whichever comes first, after the goods/service is delivered." }, { "value": "SUBSCRIPTION_PREPAID", "description": "Subscription plan where the \"amount due\" and the \"billing frequency\" are fixed, and there is no defined duration with the payment due before the good/service is delivered." }, { "value": "SUBSCRIPTION_POSTPAID", "description": "Subscription plan where the \"amount due\" and the \"billing frequency\" are fixed, and there is no defined duration with the payment due after the goods/services are delivered." }, { "value": "UNSCHEDULED_PREPAID", "description": "Unscheduled card on file plan where the merchant can bill buyer upfront based on an agreed logic, but \"amount due\" and \"frequency\" can vary. Inclusive of automatic reload plans." }, { "value": "UNSCHEDULED_POSTPAID", "description": "Unscheduled card on file plan where the merchant can bill buyer based on an agreed logic, but \"amount due\" and \"frequency\" can vary. Inclusive of automatic reload plans." }, { "value": "INSTALLMENT_PREPAID", "description": "Merchant-managed installment plan when the \"amount\" to be paid and the \"billing frequency\" are fixed, but there is a defined number of payments with the payment due before the good/service is delivered." }, { "value": "INSTALLMENT_POSTPAID", "description": "Merchant-managed installment plan when the \"amount\" to be paid and the \"billing frequency\" are fixed, but there is a defined number of payments with the payment due after the goods/services are delivered." } ], "enum": [ "IMMEDIATE", "DEFERRED", "RECURRING_PREPAID", "RECURRING_POSTPAID", "THRESHOLD_PREPAID", "THRESHOLD_POSTPAID", "SUBSCRIPTION_PREPAID", "SUBSCRIPTION_POSTPAID", "UNSCHEDULED_PREPAID", "UNSCHEDULED_POSTPAID", "INSTALLMENT_PREPAID", "INSTALLMENT_POSTPAID" ] }, "checkout_payment_intent": { "type": "string", "title": "Checkout Payment Intent", "description": "The intent to either capture payment immediately or authorize a payment for an order after order creation.", "x-enumDescriptions": [ { "value": "CAPTURE", "description": "The merchant intends to capture payment immediately after the customer makes a payment." }, { "value": "AUTHORIZE", "description": "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 `purchase_unit` within your order." } ], "enum": ["CAPTURE", "AUTHORIZE"] }, "cobranded_card": { "type": "object", "title": "cobranded card", "description": "Details about the merchant cobranded card used for order purchase.", "properties": { "labels": { "$ref": "#/components/schemas/labels_list" }, "payee": { "description": "The details for the merchant who receives the funds and fulfills the order. The merchant is also known as the payee.", "type": "object", "title": "Payee Base", "properties": { "email_address": { "description": "The email address of merchant.", "$ref": "#/components/schemas/email" }, "merchant_id": { "description": "The encrypted PayPal account ID of the merchant.", "$ref": "#/components/schemas/account_id" } } }, "amount": { "description": "Amount that was charged to the cobranded card.", "$ref": "#/components/schemas/money" } } }, "cobranded_card_list": { "type": "array", "description": "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).", "minItems": 0, "maxItems": 25, "items": { "$ref": "#/components/schemas/cobranded_card" } }, "confirm_order_request": { "title": "Confirm Order Request", "description": "Payer confirms the intent to pay for the Order using the provided payment source.", "properties": { "payment_source": { "$ref": "#/components/schemas/payment_source" }, "processing_instruction": { "$ref": "#/components/schemas/processing_instruction" }, "application_context": { "$ref": "#/components/schemas/order_confirm_application_context" } }, "required": ["payment_source"] }, "country_code": { "type": "string", "description": "The [2-character ISO 3166-1 code](/api/rest/reference/country-codes/) that identifies the country or region.
Note: The country code for Great Britain is GB and not UK as used in the top-level domain names for that country. Use the `C2` country code for China worldwide for comparable uncontrolled price (CUP) method, bank card, and cross-border transactions.
", "format": "ppaas_common_country_code_v2", "maxLength": 2, "minLength": 2, "pattern": "^([A-Z]{2}|C2)$" }, "country_code-2": { "type": "string", "description": "The [two-character ISO 3166-1 code](/api/rest/reference/country-codes/) that identifies the country or region.
Note: The country code for Great Britain is GB and not UK as used in the top-level domain names for that country. Use the `C2` country code for China worldwide for comparable uncontrolled price (CUP) method, bank card, and cross-border transactions.
", "format": "ppaas_common_country_code_v2", "maxLength": 2, "minLength": 2, "pattern": "^([A-Z]{2}|C2)$" }, "crypto": {}, "crypto_request": {}, "currency_code": { "description": "The [three-character ISO-4217 currency code](/api/rest/reference/currency-codes/) that identifies the currency.", "type": "string", "minLength": 3, "maxLength": 3, "x-security-classification": { "data_class": "class4", "data_category": "INTRINSIC" } }, "currency_code-2": { "description": "The [3-character ISO-4217 currency code](/api/rest/reference/currency-codes/) that identifies the currency.", "type": "string", "minLength": 3, "maxLength": 3, "x-security-classification": { "data_class": "class4", "data_category": "INTRINSIC" } }, "customer": { "type": "object", "title": "Customer Information", "description": "This object represents a merchant’s customer, allowing them to store contact details, and track all payments associated with the same customer.", "properties": { "id": { "$ref": "#/components/schemas/merchant_partner_customer_id" }, "email_address": { "description": "Email address of the customer 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.", "$ref": "#/components/schemas/email" }, "phone": { "description": "The phone number of the customer as provided to the merchant or on file with the merchant. The `phone.phone_number` supports only `national_number`.", "$ref": "#/components/schemas/phone_with_type" }, "name": { "description": "The name of the party.", "type": "object", "title": "Name", "properties": { "given_name": { "type": "string", "description": "When the party is a person, the party's given, or first, name.", "maxLength": 140 }, "surname": { "type": "string", "description": "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.", "maxLength": 140 } } } } }, "date_no_time": { "type": "string", "description": "The stand-alone date, in [Internet date and time format](https://tools.ietf.org/html/rfc3339#section-5.6). To represent special legal values, such as a date of birth, you should use dates with no associated time or time-zone data. Whenever possible, use the standard `date_time` type. This regular expression does not validate all dates. For example, February 31 is valid and nothing is known about leap years.", "format": "ppaas_date_notime_v2", "minLength": 10, "maxLength": 10, "pattern": "^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|3[0-1])$" }, "date_time": { "type": "string", "description": "The date and time, in [Internet date and time format](https://tools.ietf.org/html/rfc3339#section-5.6). Seconds are required while fractional seconds are optional.
Note: The regular expression provides guidance but does not reject all invalid dates.
", "format": "ppaas_date_time_v3", "minLength": 20, "maxLength": 64, "pattern": "^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|3[0-1])[T,t]([0-1][0-9]|2[0-3]):[0-5][0-9]:([0-5][0-9]|60)([.][0-9]+)?([Zz]|[+-][0-9]{2}:[0-9]{2})$" }, "date_year_month": { "type": "string", "description": "The year and month, in ISO-8601 `YYYY-MM` date format. See [Internet date and time format](https://tools.ietf.org/html/rfc3339#section-5.6).", "minLength": 7, "maxLength": 7, "pattern": "^[0-9]{4}-(0[1-9]|1[0-2])$" }, "definitions-link_description_list": { "type": "array", "description": "An array of request-related HATEOAS links.", "readOnly": true, "items": { "$ref": "#/components/schemas/link_description" } }, "definitions-platform_fee_list": { "type": "array", "description": "An array of platform or partner fees, commissions, or brokerage fees that associated with the captured payment.", "minItems": 0, "maxItems": 1, "items": { "$ref": "#/components/schemas/platform_fee" } }, "definitions-purchase_unit_request_list": { "type": "array", "description": "An array of purchase units. At present only 1 purchase_unit is supported. 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.", "minItems": 1, "maxItems": 1, "items": { "$ref": "#/components/schemas/purchase_unit_request" } }, "definitions-shipping_option_list": { "type": "array", "minItems": 1, "maxItems": 10, "description": "An array of shipping options that the payee or merchant offers to the payer to ship or pick up their items.", "items": { "$ref": "#/components/schemas/shipping_option" } }, "disbursement_mode": { "type": "string", "title": "Disbursement Mode", "description": "The funds that are held on behalf of the merchant.", "default": "INSTANT", "minLength": 1, "maxLength": 16, "pattern": "^[A-Z_]+$", "x-enumDescriptions": [ { "value": "INSTANT", "description": "The funds are released to the merchant immediately.", "default": "INSTANT" }, { "value": "DELAYED", "description": "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." } ], "enum": ["INSTANT", "DELAYED"] }, "dispute_categories": { "type": "string", "description": "The condition that is covered for the transaction.", "x-enumDescriptions": [ { "value": "ITEM_NOT_RECEIVED", "description": "The payer paid for an item that they did not receive." }, { "value": "UNAUTHORIZED_TRANSACTION", "description": "The payer did not authorize the payment." } ], "enum": ["ITEM_NOT_RECEIVED", "UNAUTHORIZED_TRANSACTION"] }, "dispute_categories_list": { "type": "array", "description": "An array of conditions that are covered for the transaction.", "items": { "$ref": "#/components/schemas/dispute_categories" }, "readOnly": true }, "eci_flag": { "type": "string", "minLength": 1, "maxLength": 255, "pattern": "^[0-9A-Z_]+$", "description": "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.", "x-enumDescriptions": [ { "value": "MASTERCARD_NON_3D_SECURE_TRANSACTION", "description": "Mastercard non-3-D Secure transaction." }, { "value": "MASTERCARD_ATTEMPTED_AUTHENTICATION_TRANSACTION", "description": "Mastercard attempted authentication transaction." }, { "value": "MASTERCARD_FULLY_AUTHENTICATED_TRANSACTION", "description": "Mastercard fully authenticated transaction." }, { "value": "FULLY_AUTHENTICATED_TRANSACTION", "description": "VISA, AMEX, JCB, DINERS CLUB fully authenticated transaction." }, { "value": "ATTEMPTED_AUTHENTICATION_TRANSACTION", "description": "VISA, AMEX, JCB, DINERS CLUB attempted authentication transaction." }, { "value": "NON_3D_SECURE_TRANSACTION", "description": "VISA, AMEX, JCB, DINERS CLUB non-3-D Secure transaction." } ], "enum": [ "MASTERCARD_NON_3D_SECURE_TRANSACTION", "MASTERCARD_ATTEMPTED_AUTHENTICATION_TRANSACTION", "MASTERCARD_FULLY_AUTHENTICATED_TRANSACTION", "FULLY_AUTHENTICATED_TRANSACTION", "ATTEMPTED_AUTHENTICATION_TRANSACTION", "NON_3D_SECURE_TRANSACTION" ] }, "email": { "type": "string", "description": "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.
", "format": "merchant_common_email_address_v2", "maxLength": 254, "minLength": 3, "pattern": "(?:[a-zA-Z0-9!#$%&'*+/=?^_`{|}~-]+(?:\\.[a-zA-Z0-9!#$%&'*+/=?^_`{|}~-]+)*|(?:[\\x01-\\x08\\x0b\\x0c\\x0e-\\x1f\\x21\\x23-\\x5b\\x5d-\\x7f]|\\[\\x01-\\x09\\x0b\\x0c\\x0e-\\x7f])*\")@(?:(?:[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?\\.)+[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?|\\[(?:(?:(2(5[0-5]|[0-4][0-9])|1[0-9][0-9]|[1-9]?[0-9]))\\.){3}(?:(2(5[0-5]|[0-4][0-9])|1[0-9][0-9]|[1-9]?[0-9])|[a-zA-Z0-9-]*[a-zA-Z0-9]:(?:[\\x01-\\x08\\x0b\\x0c\\x0e-\\x1f\\x21-\\x5a\\x53-\\x7f]|\\[\\x01-\\x09\\x0b\\x0c\\x0e-\\x7f])+)\\])" }, "email_address": { "type": "string", "description": "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.
", "format": "ppaas_common_email_address_v2", "minLength": 3, "maxLength": 254, "pattern": "^(?:[A-Za-z0-9!#$%&'*+/=?^_`{|}~-]+(?:\\.[A-Za-z0-9!#$%&'*+/=?^_`{|}~-]+)*|\"(?:[\\x01-\\x08\\x0b\\x0c\\x0e-\\x1f\\x21\\x23-\\x5b\\x5d-\\x7f]|\\\\[\\x01-\\x09\\x0b\\x0c\\x0e-\\x7f])*\")@(?:(?:[A-Za-z0-9](?:[A-Za-z0-9-]*[A-Za-z0-9])?\\.)+[A-Za-z0-9](?:[A-Za-z0-9-]*[A-Za-z0-9])?|\\[(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?|[A-Za-z0-9-]*[A-Za-z0-9]:(?:[\\x01-\\x08\\x0b\\x0c\\x0e-\\x1f\\x21-\\x5a\\x53-\\x7f]|\\\\[\\x01-\\x09\\x0b\\x0c\\x0e-\\x7f])+)\\])$" }, "enrolled": { "type": "string", "minLength": 1, "maxLength": 255, "pattern": "^[0-9A-Z_]+$", "description": "Status of Authentication eligibility.", "x-enumDescriptions": [ { "value": "Y", "description": "Yes. The bank is participating in 3-D Secure protocol and will return the ACSUrl." }, { "value": "N", "description": "No. The bank is not participating in 3-D Secure protocol." }, { "value": "U", "description": "Unavailable. The DS or ACS is not available for authentication at the time of the request." }, { "value": "B", "description": "Bypass. The merchant authentication rule is triggered to bypass authentication." } ], "enum": ["Y", "N", "U", "B"] }, "eps": { "type": "object", "title": "EPS payment object", "description": "Information used to pay using eps.", "properties": { "name": { "description": "The name of the account holder associated with this payment method.", "$ref": "#/components/schemas/full_name" }, "country_code": { "description": "The two-character ISO 3166-1 country code.", "$ref": "#/components/schemas/country_code-2" }, "bic": { "description": "The bank identification code (BIC).", "$ref": "#/components/schemas/bic" } } }, "eps_request": { "type": "object", "title": "EPS payment request", "description": "Information needed to pay using eps.", "properties": { "name": { "description": "The name of the account holder associated with this payment method.", "$ref": "#/components/schemas/full_name" }, "country_code": { "description": "The two-character ISO 3166-1 country code.", "$ref": "#/components/schemas/country_code-2" }, "experience_context": { "description": "Customizes the payer experience during the approval process for the payment.", "$ref": "#/components/schemas/experience_context_base" } }, "required": ["name", "country_code"] }, "error_400": { "type": "object", "title": "Bad Request Error", "description": "Request is not well-formed, syntactically incorrect, or violates schema.", "properties": { "name": { "type": "string", "enum": ["INVALID_REQUEST"] }, "message": { "type": "string", "enum": [ "Request is not well-formed, syntactically incorrect, or violates schema." ] }, "details": { "type": "array", "items": { "$ref": "#/components/schemas/error_details" } }, "debug_id": { "type": "string", "description": "The PayPal internal ID. Used for correlation purposes." }, "links": { "description": "An array of request-related [HATEOAS links](https://en.wikipedia.org/wiki/HATEOAS).", "type": "array", "minItems": 0, "maxItems": 10000, "items": { "$ref": "#/components/schemas/error_link_description" } } } }, "error_401": { "type": "object", "title": "Unauthorized Error", "description": "Authentication failed due to missing Authorization header, or invalid authentication credentials.", "properties": { "name": { "type": "string", "enum": ["AUTHENTICATION_FAILURE"] }, "message": { "type": "string", "enum": [ "Authentication failed due to missing authorization header, or invalid authentication credentials." ] }, "details": { "type": "array", "items": { "$ref": "#/components/schemas/error_details" } }, "debug_id": { "type": "string", "description": "The PayPal internal ID. Used for correlation purposes." }, "links": { "description": "An array of request-related [HATEOAS links](https://en.wikipedia.org/wiki/HATEOAS).", "type": "array", "minItems": 0, "maxItems": 10000, "items": { "$ref": "#/components/schemas/error_link_description" } } } }, "error_403": { "type": "object", "title": "Not Authorized Error", "description": "The client is not authorized to access this resource, although it may have valid credentials. ", "properties": { "name": { "type": "string", "enum": ["NOT_AUTHORIZED"] }, "message": { "type": "string", "enum": ["Authorization failed due to insufficient permissions."] }, "details": { "type": "array", "items": { "$ref": "#/components/schemas/error_details" } }, "debug_id": { "type": "string", "description": "The PayPal internal ID. Used for correlation purposes." }, "links": { "description": "An array of request-related [HATEOAS links](https://en.wikipedia.org/wiki/HATEOAS).", "type": "array", "minItems": 0, "maxItems": 10000, "items": { "$ref": "#/components/schemas/error_link_description" } } } }, "error_404": { "type": "object", "title": "Not found Error", "description": "The server has not found anything matching the request URI. This either means that the URI is incorrect or the resource is not available.", "properties": { "name": { "type": "string", "enum": ["RESOURCE_NOT_FOUND"] }, "message": { "type": "string", "enum": ["The specified resource does not exist."] }, "details": { "type": "array", "items": { "$ref": "#/components/schemas/error_details" } }, "debug_id": { "type": "string", "description": "The PayPal internal ID. Used for correlation purposes." }, "links": { "description": "An array of request-related [HATEOAS links](https://en.wikipedia.org/wiki/HATEOAS).", "type": "array", "minItems": 0, "maxItems": 10000, "items": { "$ref": "#/components/schemas/error_link_description" } } } }, "error_409": { "type": "object", "title": "Resource Conflict Error", "description": "The server has detected a conflict while processing this request.", "properties": { "name": { "type": "string", "enum": ["RESOURCE_CONFLICT"] }, "message": { "type": "string", "enum": [ "The server has detected a conflict while processing this request." ] }, "details": { "type": "array", "items": { "$ref": "#/components/schemas/error_details" } }, "debug_id": { "type": "string", "description": "The PayPal internal ID. Used for correlation purposes." }, "links": { "description": "An array of request-related [HATEOAS links](https://en.wikipedia.org/wiki/HATEOAS).", "type": "array", "minItems": 0, "maxItems": 10000, "items": { "$ref": "#/components/schemas/error_link_description" } } } }, "error_415": { "type": "object", "title": "Unsupported Media Type Error", "description": "The server does not support the request payload's media type.", "properties": { "name": { "type": "string", "enum": ["UNSUPPORTED_MEDIA_TYPE"] }, "message": { "type": "string", "enum": [ "The server does not support the request payload's media type." ] }, "details": { "type": "array", "items": { "$ref": "#/components/schemas/error_details" } }, "debug_id": { "type": "string", "description": "The PayPal internal ID. Used for correlation purposes." }, "links": { "description": "An array of request-related [HATEOAS links](https://en.wikipedia.org/wiki/HATEOAS).", "type": "array", "minItems": 0, "maxItems": 10000, "items": { "$ref": "#/components/schemas/error_link_description" } } } }, "error_422": { "type": "object", "title": "Unprocessable Entity Error", "description": "The requested action cannot be performed and may require interaction with APIs or processes outside of the current request. This is distinct from a 500 response in that there are no systemic problems limiting the API from performing the request.", "properties": { "name": { "type": "string", "enum": ["UNPROCESSABLE_ENTITY"] }, "message": { "type": "string", "enum": [ "The requested action could not be performed, semantically incorrect, or failed business validation." ] }, "details": { "type": "array", "items": { "$ref": "#/components/schemas/error_details" } }, "debug_id": { "type": "string", "description": "The PayPal internal ID. Used for correlation purposes." }, "links": { "description": "An array of request-related [HATEOAS links](https://en.wikipedia.org/wiki/HATEOAS).", "type": "array", "minItems": 0, "maxItems": 10000, "items": { "$ref": "#/components/schemas/error_link_description" } } } }, "error_500": { "type": "object", "title": "Internal Server Error", "description": "This is either a system or application error, and generally indicates that although the client appeared to provide a correct request, something unexpected has gone wrong on the server.", "properties": { "name": { "type": "string", "enum": ["INTERNAL_SERVER_ERROR"] }, "message": { "type": "string", "enum": ["An internal server error occurred."] }, "debug_id": { "type": "string", "description": "The PayPal internal ID. Used for correlation purposes." }, "links": { "description": "An array of request-related [HATEOAS links](https://en.wikipedia.org/wiki/HATEOAS).", "type": "array", "minItems": 0, "maxItems": 10000, "items": { "$ref": "#/components/schemas/error_link_description" } } }, "example": { "name": "INTERNAL_SERVER_ERROR", "message": "An internal server error occurred.", "debug_id": "90957fca61718", "links": [ { "href": "https://developer.paypal.com/api/orders/v2/#error-INTERNAL_SERVER_ERROR", "rel": "information_link" } ] } }, "error_503": { "type": "object", "title": "Service Unavailable Error", "description": "The server is temporarily unable to handle the request, for example, because of planned maintenance or downtime.", "properties": { "name": { "type": "string", "enum": ["SERVICE_UNAVAILABLE"] }, "message": { "type": "string", "enum": ["Service Unavailable."] }, "debug_id": { "type": "string", "description": "The PayPal internal ID. Used for correlation purposes." }, "links": { "description": "An array of request-related [HATEOAS links](https://en.wikipedia.org/wiki/HATEOAS).", "type": "array", "minItems": 0, "maxItems": 10000, "items": { "$ref": "#/components/schemas/error_link_description" } } }, "example": { "name": "SERVICE_UNAVAILABLE", "message": "Service Unavailable.", "debug_id": "90957fca61718", "information_link": "https://developer.paypal.com/docs/api/orders/v2/#error-SERVICE_UNAVAILABLE" } }, "error_default": { "description": "The default error response.", "oneOf": [ { "$ref": "#/components/schemas/error_400" }, { "$ref": "#/components/schemas/error_401" }, { "$ref": "#/components/schemas/error_403" }, { "$ref": "#/components/schemas/error_404" }, { "$ref": "#/components/schemas/error_409" }, { "$ref": "#/components/schemas/error_415" }, { "$ref": "#/components/schemas/error_422" }, { "$ref": "#/components/schemas/error_500" }, { "$ref": "#/components/schemas/error_503" } ] }, "error_details": { "title": "Error Details", "type": "object", "description": "The error details. Required for client-side `4XX` errors.", "properties": { "field": { "type": "string", "description": "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": { "type": "string", "description": "The value of the field that caused the error." }, "location": { "$ref": "#/components/schemas/error_location" }, "issue": { "type": "string", "description": "The unique, fine-grained application-level error code." }, "description": { "type": "string", "description": "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." } }, "required": ["issue"] }, "error_link_description": { "title": "Link Description", "description": "The request-related [HATEOAS link](/api/rest/responses/#hateoas-links) information.", "type": "object", "required": ["href", "rel"], "properties": { "href": { "description": "The complete target URL. To make the related call, combine the method with this [URI Template-formatted](https://tools.ietf.org/html/rfc6570) link. For pre-processing, include the `$`, `(`, and `)` characters. The `href` is the key HATEOAS component that links a completed call with a subsequent call.", "type": "string", "minLength": 0, "maxLength": 20000, "pattern": "^.*$" }, "rel": { "description": "The [link relation type](https://tools.ietf.org/html/rfc5988#section-4), which serves as an ID for a link that unambiguously describes the semantics of the link. See [Link Relations](https://www.iana.org/assignments/link-relations/link-relations.xhtml).", "type": "string", "minLength": 0, "maxLength": 100, "pattern": "^.*$" }, "method": { "description": "The HTTP method required to make the related call.", "type": "string", "minLength": 3, "maxLength": 6, "pattern": "^[A-Z]*$", "enum": ["GET", "POST", "PUT", "DELETE", "PATCH"] } } }, "error_location": { "type": "string", "description": "The location of the field that caused the error. Value is `body`, `path`, or `query`.", "enum": ["body", "path", "query"], "default": "body" }, "exchange_rate": { "description": "The exchange rate that determines the amount to convert from one currency to another currency.", "type": "object", "title": "Exchange Rate", "properties": { "source_currency": { "description": "The source currency from which to convert an amount.", "$ref": "#/components/schemas/currency_code" }, "target_currency": { "description": "The target currency to which to convert an amount.", "$ref": "#/components/schemas/currency_code" }, "value": { "description": "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.", "type": "string" } }, "readOnly": true }, "experience_context_base": { "type": "object", "title": "Experience Context Base", "description": "Customizes the payer experience during the approval process for the payment.", "properties": { "brand_name": { "type": "string", "description": "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.", "minLength": 1, "maxLength": 127, "pattern": "^.*$" }, "locale": { "description": "The BCP 47-formatted locale of pages that the PayPal payment experience shows. PayPal supports a five-character code. For example, `da-DK`, `he-IL`, `id-ID`, `ja-JP`, `no-NO`, `pt-BR`, `ru-RU`, `sv-SE`, `th-TH`, `zh-CN`, `zh-HK`, or `zh-TW`.", "$ref": "#/components/schemas/language" }, "shipping_preference": { "type": "string", "description": "The location from which the shipping address is derived.", "minLength": 1, "maxLength": 24, "pattern": "^[A-Z_]+$", "default": "GET_FROM_FILE", "x-enumDescriptions": [ { "value": "GET_FROM_FILE", "description": "Get the customer-provided shipping address on the PayPal site." }, { "value": "NO_SHIPPING", "description": "Redacts the shipping address from the PayPal site. Recommended for digital goods." }, { "value": "SET_PROVIDED_ADDRESS", "description": "Get the merchant-provided address. The customer cannot change this address on the PayPal site. If merchant does not pass an address, customer can choose the address on PayPal pages." } ], "enum": ["GET_FROM_FILE", "NO_SHIPPING", "SET_PROVIDED_ADDRESS"] }, "return_url": { "description": "The URL where the customer is redirected after the customer approves the payment.", "format": "uri", "$ref": "#/components/schemas/url" }, "cancel_url": { "description": "The URL where the customer is redirected after the customer cancels the payment.", "format": "uri", "$ref": "#/components/schemas/url" } } }, "experience_context_swish": { "type": "object", "title": "Experience Context Swish", "description": "Customizes the payer experience during the approval process for the payment.", "properties": { "brand_name": { "type": "string", "description": "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.", "minLength": 1, "maxLength": 127, "pattern": "^.*$" }, "locale": { "description": "The BCP 47-formatted locale of pages that the PayPal payment experience shows. PayPal supports a five-character code. For example, `da-DK`, `he-IL`, `id-ID`, `ja-JP`, `no-NO`, `pt-BR`, `ru-RU`, `sv-SE`, `th-TH`, `zh-CN`, `zh-HK`, or `zh-TW`.", "$ref": "#/components/schemas/language" }, "shipping_preference": { "type": "string", "description": "The location from which the shipping address is derived.", "minLength": 1, "maxLength": 24, "pattern": "^[A-Z0-9_]+$", "default": "GET_FROM_FILE", "x-enumDescriptions": [ { "value": "GET_FROM_FILE", "description": "Get the customer-provided shipping address on the PayPal site." }, { "value": "NO_SHIPPING", "description": "Redacts the shipping address from the PayPal site. Recommended for digital goods." }, { "value": "SET_PROVIDED_ADDRESS", "description": "Get the merchant-provided address. The customer cannot change this address on the PayPal site. If merchant does not pass an address, customer can choose the address on PayPal pages." } ], "enum": ["GET_FROM_FILE", "NO_SHIPPING", "SET_PROVIDED_ADDRESS"] }, "return_url": { "description": "The URL where the customer is redirected after the customer approves the payment.", "format": "uri", "$ref": "#/components/schemas/url" }, "cancel_url": { "description": "The URL where the customer is redirected after the customer cancels the payment.", "format": "uri", "$ref": "#/components/schemas/url" }, "return_intent_url": { "description": "The URL where we identify whether intent_url field should be returned in the response.", "format": "uri", "$ref": "#/components/schemas/url" } } }, "frequency": {}, "full_name": { "type": "string", "description": "The full name representation like Mr J Smith.", "minLength": 3, "maxLength": 300 }, "giropay": { "type": "object", "title": "Giropay payment object", "description": "Information needed to pay using giropay.", "properties": { "name": { "description": "The name of the account holder associated with this payment method.", "$ref": "#/components/schemas/full_name" }, "country_code": { "description": "The two-character ISO 3166-1 country code.", "$ref": "#/components/schemas/country_code-2" }, "bic": { "description": "The bank identification code (BIC).", "$ref": "#/components/schemas/bic" } } }, "giropay_request": { "type": "object", "title": "Giropay payment request", "description": "Information needed to pay using giropay.", "properties": { "name": { "description": "The name of the account holder associated with this payment method.", "$ref": "#/components/schemas/full_name" }, "country_code": { "description": "The two-character ISO 3166-1 country code.", "$ref": "#/components/schemas/country_code-2" }, "experience_context": { "description": "Customizes the payer experience during the approval process for the payment.", "$ref": "#/components/schemas/experience_context_base" } }, "required": ["name", "country_code"] }, "google_pay": { "type": "object", "title": "Google Pay Wallet Response", "description": "Google Pay Wallet payment data.", "properties": { "name": { "description": "Name on the account holder associated with Google Pay.", "$ref": "#/components/schemas/full_name" }, "email_address": { "description": "The email address of the account holder associated with Google Pay.", "$ref": "#/components/schemas/email_address" }, "phone_number": { "description": "The phone number in its canonical international [E.164 numbering plan format](https://www.itu.int/rec/T-REC-E.164/en).", "type": "object", "title": "Phone", "properties": { "country_code": { "type": "string", "description": "The country calling code (CC), in its canonical international [E.164 numbering plan format](https://www.itu.int/rec/T-REC-E.164/en). 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).", "minLength": 1, "maxLength": 3, "pattern": "^[0-9]{1,3}?$" }, "national_number": { "type": "string", "description": "The national number, in its canonical international [E.164 numbering plan format](https://www.itu.int/rec/T-REC-E.164/en). 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).", "minLength": 1, "maxLength": 14, "pattern": "^[0-9]{1,14}?$" } }, "required": ["country_code", "national_number"] }, "card": { "description": "The Card from Google Pay Wallet used to fund the payment.", "$ref": "#/components/schemas/google_pay_card_response" } } }, "google_pay_attributes": {}, "google_pay_card_response": { "type": "object", "title": "Google Pay Card Response", "description": "The payment card to use to fund a Google Pay payment response. Can be a credit or debit card.", "properties": { "name": { "type": "string", "description": "The card holder's name as it appears on the card.", "maxLength": 300, "minLength": 1, "pattern": "^.{1,300}$" }, "last_digits": { "type": "string", "description": "The last digits of the payment card.", "pattern": "^[0-9]{2,4}$", "minLength": 2, "maxLength": 4, "readOnly": true }, "type": { "description": "The payment card type.", "$ref": "#/components/schemas/card_type" }, "brand": { "description": "The card brand or network. Typically used in the response.", "$ref": "#/components/schemas/card_brand" }, "billing_address": { "description": "The portable international postal address. Maps to [AddressValidationMetadata](https://github.com/googlei18n/libaddressinput/wiki/AddressValidationMetadata) and HTML 5.1 [Autofilling form controls: the autocomplete attribute](https://www.w3.org/TR/html51/sec-forms.html#autofilling-form-controls-the-autocomplete-attribute).", "type": "object", "title": "Portable Postal Address (Medium-Grained)", "properties": { "address_line_1": { "type": "string", "description": "The first line of the address, such as number and street, for example, `173 Drury Lane`. Needed for data entry, and Compliance and Risk checks. This field needs to pass the full address.", "maxLength": 300 }, "address_line_2": { "type": "string", "description": "The second line of the address, for example, a suite or apartment number.", "maxLength": 300 }, "admin_area_2": { "type": "string", "description": "A city, town, or village. Smaller than `admin_area_level_1`.", "maxLength": 120 }, "admin_area_1": { "type": "string", "description": "The highest-level sub-division in a country, which is usually a province, state, or ISO-3166-2 subdivision. This data is formatted for postal delivery, for example, `CA` and not `California`. Value, by country, is:", "maxLength": 300 }, "postal_code": { "type": "string", "description": "The postal code, which is the ZIP code or equivalent. Typically required for countries with a postal code or an equivalent. See [postal code](https://en.wikipedia.org/wiki/Postal_code).", "maxLength": 60 }, "country_code": { "$ref": "#/components/schemas/country_code" } }, "required": ["country_code"] }, "authentication_result": { "$ref": "#/components/schemas/authentication_response" } } }, "google_pay_decrypted_token_data": { "type": "object", "title": "Google Pay payment request object", "description": "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.", "properties": { "message_id": { "description": "A unique ID that identifies the message in case it needs to be revoked or located at a later time.", "type": "string", "minLength": 1, "maxLength": 250, "pattern": "^.*$" }, "message_expiration": { "description": "Date and time at which the message expires as UTC milliseconds since epoch. Integrators should reject any message that's expired.", "type": "string", "pattern": "\\d{13}", "minLength": 13, "maxLength": 13 }, "payment_method": { "description": "The type of the payment credential. Currently, only CARD is supported.", "type": "string", "minLength": 4, "maxLength": 4, "x-enumDescriptions": [ { "value": "CARD", "description": "CARD is the only value that Google Pay accepts." } ], "enum": ["CARD"] }, "card": { "description": "The payment card used to fund a Google Pay payment. Can be a credit or debit card.", "type": "object", "title": "Google Pay Card", "properties": { "name": { "type": "string", "description": "The card holder's name as it appears on the card.", "maxLength": 300, "minLength": 1, "pattern": "^.{1,300}$" }, "number": { "type": "string", "description": "The primary account number (PAN) for the payment card.", "pattern": "^[0-9]{13,19}$", "minLength": 13, "maxLength": 19 }, "expiry": { "description": "The card expiration year and month, in [Internet date format](https://tools.ietf.org/html/rfc3339#section-5.6).", "$ref": "#/components/schemas/date_year_month" }, "last_digits": { "type": "string", "description": "The last digits of the payment card.", "pattern": "^[0-9]{2,4}$", "minLength": 2, "maxLength": 4, "readOnly": true }, "type": { "description": "The payment card type.", "$ref": "#/components/schemas/card_type" }, "brand": { "description": "The card brand or network. Typically used in the response.", "$ref": "#/components/schemas/card_brand" }, "billing_address": { "description": "The portable international postal address. Maps to [AddressValidationMetadata](https://github.com/googlei18n/libaddressinput/wiki/AddressValidationMetadata) and HTML 5.1 [Autofilling form controls: the autocomplete attribute](https://www.w3.org/TR/html51/sec-forms.html#autofilling-form-controls-the-autocomplete-attribute).", "type": "object", "title": "Portable Postal Address (Medium-Grained)", "properties": { "address_line_1": { "type": "string", "description": "The first line of the address, such as number and street, for example, `173 Drury Lane`. Needed for data entry, and Compliance and Risk checks. This field needs to pass the full address.", "maxLength": 300 }, "address_line_2": { "type": "string", "description": "The second line of the address, for example, a suite or apartment number.", "maxLength": 300 }, "admin_area_2": { "type": "string", "description": "A city, town, or village. Smaller than `admin_area_level_1`.", "maxLength": 120 }, "admin_area_1": { "type": "string", "description": "The highest-level sub-division in a country, which is usually a province, state, or ISO-3166-2 subdivision. This data is formatted for postal delivery, for example, `CA` and not `California`. Value, by country, is:", "maxLength": 300 }, "postal_code": { "type": "string", "description": "The postal code, which is the ZIP code or equivalent. Typically required for countries with a postal code or an equivalent. See [postal code](https://en.wikipedia.org/wiki/Postal_code).", "maxLength": 60 }, "country_code": { "$ref": "#/components/schemas/country_code" } }, "required": ["country_code"] } } }, "authentication_method": { "description": "Authentication Method which is used for the card transaction.", "type": "string", "minLength": 1, "maxLength": 50, "x-enumDescriptions": [ { "value": "PAN_ONLY", "description": "This authentication method is associated with payment cards stored on file with the user's Google Account. Returned payment data includes primary account number (PAN) with the expiration month and the expiration year." }, { "value": "CRYPTOGRAM_3DS", "description": "Returned payment data includes a 3-D Secure (3DS) cryptogram generated on the device. -> If authentication_method=CRYPTOGRAM, it is required that 'cryptogram' parameter in the request has a valid 3-D Secure (3DS) cryptogram generated on the device." } ], "enum": ["PAN_ONLY", "CRYPTOGRAM_3DS"] }, "cryptogram": { "description": "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.", "type": "string", "minLength": 1, "maxLength": 2000 }, "eci_indicator": { "description": "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.", "type": "string", "minLength": 1, "maxLength": 256, "pattern": "^.*$" } }, "required": ["payment_method", "card", "authentication_method"] }, "google_pay_experience_context": { "type": "object", "title": "Google Pay Experience Context", "description": "Customizes the payer experience during the approval process for the payment.", "properties": { "return_url": { "description": "The URL where the customer is redirected after the customer approves the payment.", "format": "uri", "$ref": "#/components/schemas/url" }, "cancel_url": { "description": "The URL where the customer is redirected after the customer cancels the payment.", "format": "uri", "$ref": "#/components/schemas/url" } }, "required": ["return_url", "cancel_url"] }, "google_pay_request": { "type": "object", "title": "Google Pay payment request object", "description": "Information needed to pay using Google Pay.", "properties": { "name": { "description": "Name on the account holder associated with Google Pay.", "$ref": "#/components/schemas/full_name" }, "email_address": { "description": "The email address of the account holder associated with Google Pay.", "$ref": "#/components/schemas/email_address" }, "phone_number": { "description": "The phone number in its canonical international [E.164 numbering plan format](https://www.itu.int/rec/T-REC-E.164/en).", "type": "object", "title": "Phone", "properties": { "country_code": { "type": "string", "description": "The country calling code (CC), in its canonical international [E.164 numbering plan format](https://www.itu.int/rec/T-REC-E.164/en). 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).", "minLength": 1, "maxLength": 3, "pattern": "^[0-9]{1,3}?$" }, "national_number": { "type": "string", "description": "The national number, in its canonical international [E.164 numbering plan format](https://www.itu.int/rec/T-REC-E.164/en). 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).", "minLength": 1, "maxLength": 14, "pattern": "^[0-9]{1,14}?$" } }, "required": ["country_code", "national_number"] }, "card": { "description": "The payment card used to fund a Google Pay payment. Can be a credit or debit card.", "type": "object", "title": "Google Pay Card", "properties": { "name": { "type": "string", "description": "The card holder's name as it appears on the card.", "maxLength": 300, "minLength": 1, "pattern": "^.{1,300}$" }, "type": { "description": "The payment card type.", "$ref": "#/components/schemas/card_type" }, "brand": { "description": "The card brand or network. Typically used in the response.", "$ref": "#/components/schemas/card_brand" }, "billing_address": { "description": "The portable international postal address. Maps to [AddressValidationMetadata](https://github.com/googlei18n/libaddressinput/wiki/AddressValidationMetadata) and HTML 5.1 [Autofilling form controls: the autocomplete attribute](https://www.w3.org/TR/html51/sec-forms.html#autofilling-form-controls-the-autocomplete-attribute).", "type": "object", "title": "Portable Postal Address (Medium-Grained)", "properties": { "address_line_1": { "type": "string", "description": "The first line of the address, such as number and street, for example, `173 Drury Lane`. Needed for data entry, and Compliance and Risk checks. This field needs to pass the full address.", "maxLength": 300 }, "address_line_2": { "type": "string", "description": "The second line of the address, for example, a suite or apartment number.", "maxLength": 300 }, "admin_area_2": { "type": "string", "description": "A city, town, or village. Smaller than `admin_area_level_1`.", "maxLength": 120 }, "admin_area_1": { "type": "string", "description": "The highest-level sub-division in a country, which is usually a province, state, or ISO-3166-2 subdivision. This data is formatted for postal delivery, for example, `CA` and not `California`. Value, by country, is:", "maxLength": 300 }, "postal_code": { "type": "string", "description": "The postal code, which is the ZIP code or equivalent. Typically required for countries with a postal code or an equivalent. See [postal code](https://en.wikipedia.org/wiki/Postal_code).", "maxLength": 60 }, "country_code": { "$ref": "#/components/schemas/country_code" } }, "required": ["country_code"] } } }, "decrypted_token": { "description": "The decrypted payload details for the Google Pay token.", "$ref": "#/components/schemas/google_pay_decrypted_token_data" }, "assurance_details": { "description": "Information about what validation has been performed on the returned payment credentials.", "$ref": "#/components/schemas/assurance_details" }, "attributes": { "$ref": "#/components/schemas/google_pay_attributes" }, "experience_context": { "$ref": "#/components/schemas/google_pay_experience_context" } } }, "iban_last_chars": { "type": "string", "description": "The last characters of the IBAN used to pay.", "minLength": 4, "maxLength": 34, "pattern": "[a-zA-Z0-9]{4}" }, "ideal": { "type": "object", "title": "iDEAL payment object", "description": "Information used to pay using iDEAL.", "properties": { "name": { "description": "The name of the account holder associated with this payment method.", "$ref": "#/components/schemas/full_name" }, "country_code": { "description": "The two-character ISO 3166-1 country code.", "$ref": "#/components/schemas/country_code-2" }, "bic": { "description": "The bank identification code (BIC).", "$ref": "#/components/schemas/bic" }, "iban_last_chars": { "$ref": "#/components/schemas/iban_last_chars" } } }, "ideal_request": { "type": "object", "title": "Payment request for iDEAL", "description": "Information needed to pay using iDEAL.", "properties": { "name": { "description": "The name of the account holder associated with this payment method.", "$ref": "#/components/schemas/full_name" }, "country_code": { "description": "The two-character ISO 3166-1 country code.", "$ref": "#/components/schemas/country_code-2" }, "bic": { "description": "The bank identification code (BIC).", "$ref": "#/components/schemas/bic" }, "experience_context": { "description": "Customizes the payer experience during the approval process for the payment.", "$ref": "#/components/schemas/experience_context_base" } }, "required": ["name", "country_code"] }, "ip_address": { "type": "string", "title": "IP Address", "description": "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.", "format": "ppaas_ip_address_v1", "minLength": 7, "maxLength": 39, "pattern": "^(([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])$|^(([a-zA-Z]|[a-zA-Z][a-zA-Z0-9\\-]*[a-zA-Z0-9])\\.)*([A-Za-z]|[A-Za-z][A-Za-z0-9\\-]*[A-Za-z0-9])$|^\\s*((([0-9A-Fa-f]{1,4}:){7}([0-9A-Fa-f]{1,4}|:))|(([0-9A-Fa-f]{1,4}:){6}(:[0-9A-Fa-f]{1,4}|((25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)(\\.(25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)){3})|:))|(([0-9A-Fa-f]{1,4}:){5}(((:[0-9A-Fa-f]{1,4}){1,2})|:((25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)(\\.(25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)){3})|:))|(([0-9A-Fa-f]{1,4}:){4}(((:[0-9A-Fa-f]{1,4}){1,3})|((:[0-9A-Fa-f]{1,4})?:((25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)(\\.(25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)){3}))|:))|(([0-9A-Fa-f]{1,4}:){3}(((:[0-9A-Fa-f]{1,4}){1,4})|((:[0-9A-Fa-f]{1,4}){0,2}:((25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)(\\.(25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)){3}))|:))|(([0-9A-Fa-f]{1,4}:){2}(((:[0-9A-Fa-f]{1,4}){1,5})|((:[0-9A-Fa-f]{1,4}){0,3}:((25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)(\\.(25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)){3}))|:))|(([0-9A-Fa-f]{1,4}:){1}(((:[0-9A-Fa-f]{1,4}){1,6})|((:[0-9A-Fa-f]{1,4}){0,4}:((25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)(\\.(25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)){3}))|:))|(:(((:[0-9A-Fa-f]{1,4}){1,7})|((:[0-9A-Fa-f]{1,4}){0,5}:((25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)(\\.(25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)){3}))|:)))(%.+)?\\s*$" }, "item": { "type": "object", "title": "Item", "description": "The details for the items to be purchased.", "properties": { "name": { "type": "string", "description": "The item name or title.", "minLength": 1, "maxLength": 127 }, "unit_amount": { "description": "The item price or rate per unit. If you specify unit_amount, purchase_units[].amount.breakdown.item_total is required. Must equal unit_amount * quantity for all items. unit_amount.value can not be a negative number.", "$ref": "#/components/schemas/money" }, "tax": { "description": "The item tax for each unit. If tax is specified, purchase_units[].amount.breakdown.tax_total is required. Must equal tax * quantity for all items. tax.value can not be a negative number.", "$ref": "#/components/schemas/money" }, "quantity": { "type": "string", "description": "The item quantity. Must be a whole number.", "maxLength": 10, "pattern": "^[1-9][0-9]{0,9}$" }, "description": { "type": "string", "description": "The detailed item description.", "maxLength": 2048 }, "sku": { "type": "string", "description": "The stock keeping unit (SKU) for the item.", "maxLength": 127 }, "url": { "type": "string", "format": "uri", "minLength": 1, "maxLength": 2048, "description": "The URL to the item being purchased. Visible to buyer and used in buyer experiences." }, "category": { "type": "string", "description": "The item category type.", "x-enumDescriptions": [ { "value": "DIGITAL_GOODS", "description": "Goods that are stored, delivered, and used in their electronic format. This value is not currently supported for API callers that leverage the PayPal for Commerce Platform product." }, { "value": "PHYSICAL_GOODS", "description": "A tangible item that can be shipped with proof of delivery." }, { "value": "DONATION", "description": "A contribution or gift for which no good or service is exchanged, usually to a not for profit organization." } ], "minLength": 1, "maxLength": 20, "enum": ["DIGITAL_GOODS", "PHYSICAL_GOODS", "DONATION"] }, "image_url": { "type": "string", "format": "uri", "description": "The URL of the item's image. File type and size restrictions apply. An image that violates these restrictions will not be honored.", "minLength": 1, "maxLength": 2048, "pattern": "^(https:)([/|.|\\w|\\s|-])*\\.(?:jpg|gif|png|jpeg|JPG|GIF|PNG|JPEG)" }, "upc": { "description": "The Universal Product Code of the item.", "$ref": "#/components/schemas/universal_product_code" }, "billing_plan": { "$ref": "#/components/schemas/order_billing_plan" } }, "required": ["name", "unit_amount", "quantity"] }, "item_list": { "type": "array", "description": "An array of items that the customer purchases from the merchant.", "items": { "$ref": "#/components/schemas/item" } }, "labels": { "type": "string", "description": "Label for the cobranded card.", "minLength": 1, "maxLength": 256 }, "labels_list": { "type": "array", "description": "Array of labels for the cobranded card.", "minItems": 1, "maxItems": 25, "items": { "$ref": "#/components/schemas/labels" } }, "language": { "type": "string", "description": "The [language tag](https://tools.ietf.org/html/bcp47#section-2) for the language in which to localize the error-related strings, such as messages, issues, and suggested actions. The tag is made up of the [ISO 639-2 language code](https://www.loc.gov/standards/iso639-2/php/code_list.php), the optional [ISO-15924 script tag](https://www.unicode.org/iso15924/codelists.html), and the [ISO-3166 alpha-2 country code](/api/rest/reference/country-codes/) or [M49 region code](https://unstats.un.org/unsd/methodology/m49/).", "format": "ppaas_common_language_v3", "maxLength": 10, "minLength": 2, "pattern": "^[a-z]{2}(?:-[A-Z][a-z]{3})?(?:-(?:[A-Z]{2}|[0-9]{3}))?$" }, "level_2_card_processing_data": { "type": "object", "title": "Level 2 Card Processing Data", "description": "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.", "properties": { "invoice_id": { "type": "string", "description": "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.", "minLength": 1, "maxLength": 127, "pattern": "^[\\w‘\\-.,\":;\\!?]*$" }, "tax_total": { "description": "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. \n Value, by country, is:\n\n UK. A county.\n US. A state.\n Canada. A province.\n Japan. A prefecture.\n Switzerland. A kanton.\n", "$ref": "#/components/schemas/money" } } }, "level_3_card_processing_data": { "type": "object", "title": "Level 3 Card Processing Data", "description": "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.", "properties": { "shipping_amount": { "description": "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.", "$ref": "#/components/schemas/money" }, "duty_amount": { "description": "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.", "$ref": "#/components/schemas/money" }, "discount_amount": { "description": "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.", "$ref": "#/components/schemas/money" }, "shipping_address": { "description": "The portable international postal address. Maps to [AddressValidationMetadata](https://github.com/googlei18n/libaddressinput/wiki/AddressValidationMetadata) and HTML 5.1 [Autofilling form controls: the autocomplete attribute](https://www.w3.org/TR/html51/sec-forms.html#autofilling-form-controls-the-autocomplete-attribute).", "type": "object", "title": "Portable Postal Address (Medium-Grained)", "properties": { "address_line_1": { "type": "string", "description": "The first line of the address, such as number and street, for example, `173 Drury Lane`. Needed for data entry, and Compliance and Risk checks. This field needs to pass the full address.", "maxLength": 300 }, "address_line_2": { "type": "string", "description": "The second line of the address, for example, a suite or apartment number.", "maxLength": 300 }, "admin_area_2": { "type": "string", "description": "A city, town, or village. Smaller than `admin_area_level_1`.", "maxLength": 120 }, "admin_area_1": { "type": "string", "description": "The highest-level sub-division in a country, which is usually a province, state, or ISO-3166-2 subdivision. This data is formatted for postal delivery, for example, `CA` and not `California`. Value, by country, is:", "maxLength": 300 }, "postal_code": { "type": "string", "description": "The postal code, which is the ZIP code or equivalent. Typically required for countries with a postal code or an equivalent. See [postal code](https://en.wikipedia.org/wiki/Postal_code).", "maxLength": 60 }, "country_code": { "$ref": "#/components/schemas/country_code" } }, "required": ["country_code"] }, "ships_from_postal_code": { "type": "string", "description": "Use this field to specify the postal code of the shipping location.", "minLength": 1, "maxLength": 60, "pattern": "^[a-zA-Z0-9_'.-]*$" }, "line_items": { "$ref": "#/components/schemas/line_item_list" } } }, "liability_shift": { "type": "string", "minLength": 1, "maxLength": 255, "pattern": "^[0-9A-Z_]+$", "description": "Liability shift indicator. The outcome of the issuer's authentication.", "x-enumDescriptions": [ { "value": "NO", "description": "Liability is with the merchant." }, { "value": "POSSIBLE", "description": "Liability may shift to the card issuer." }, { "value": "UNKNOWN", "description": "The authentication system is not available." } ], "enum": ["NO", "POSSIBLE", "UNKNOWN"] }, "line_item": { "type": "object", "title": "Line Item", "description": "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.", "properties": { "name": { "type": "string", "description": "The item name or title.", "minLength": 1, "maxLength": 127 }, "quantity": { "type": "string", "description": "The item quantity. Must be a whole number.", "maxLength": 10, "pattern": "^[1-9][0-9]{0,9}$" }, "description": { "type": "string", "description": "The detailed item description.", "maxLength": 2048 }, "sku": { "type": "string", "description": "The stock keeping unit (SKU) for the item.", "maxLength": 127 }, "url": { "type": "string", "format": "uri", "minLength": 1, "maxLength": 2048, "description": "The URL to the item being purchased. Visible to buyer and used in buyer experiences." }, "image_url": { "type": "string", "format": "uri", "description": "The URL of the item's image. File type and size restrictions apply. An image that violates these restrictions will not be honored.", "minLength": 1, "maxLength": 2048, "pattern": "^(https:)([/|.|\\w|\\s|-])*\\.(?:jpg|gif|png|jpeg|JPG|GIF|PNG|JPEG)" }, "upc": { "description": "The Universal Product Code of the item.", "$ref": "#/components/schemas/universal_product_code" }, "billing_plan": { "$ref": "#/components/schemas/order_billing_plan" }, "unit_amount": { "description": "The item price or rate per unit. Must equal unit_amount * quantity for all items. unit_amount.value can not be a negative number.", "$ref": "#/components/schemas/money" }, "tax": { "description": "The item tax for each unit. Must equal tax * quantity for all items. tax.value can not be a negative number.", "$ref": "#/components/schemas/money" }, "commodity_code": { "type": "string", "description": "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.", "minLength": 1, "maxLength": 12, "pattern": "^[a-zA-Z0-9_'.-]*$" }, "discount_amount": { "description": "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.", "$ref": "#/components/schemas/money" }, "total_amount": { "description": "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.", "$ref": "#/components/schemas/money" }, "unit_of_measure": { "type": "string", "description": "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).", "minLength": 1, "maxLength": 12, "pattern": "^[a-zA-Z0-9_'.-]*$" } }, "required": ["name", "quantity"] }, "line_item_list": { "type": "array", "description": "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.", "minItems": 1, "maxItems": 100, "items": { "$ref": "#/components/schemas/line_item" } }, "link_description": { "type": "object", "title": "Link Description", "description": "The request-related [HATEOAS link](/api/rest/responses/#hateoas-links) information.", "required": ["href", "rel"], "properties": { "href": { "type": "string", "description": "The complete target URL. To make the related call, combine the method with this [URI Template-formatted](https://tools.ietf.org/html/rfc6570) link. For pre-processing, include the `$`, `(`, and `)` characters. The `href` is the key HATEOAS component that links a completed call with a subsequent call." }, "rel": { "type": "string", "description": "The [link relation type](https://tools.ietf.org/html/rfc5988#section-4), which serves as an ID for a link that unambiguously describes the semantics of the link. See [Link Relations](https://www.iana.org/assignments/link-relations/link-relations.xhtml)." }, "method": { "type": "string", "description": "The HTTP method required to make the related call.", "enum": [ "GET", "POST", "PUT", "DELETE", "HEAD", "CONNECT", "OPTIONS", "PATCH" ], "x-enumDescriptions": { "GET": "The HTTP GET method.", "POST": "The HTTP POST method.", "PUT": "The HTTP PUT method.", "DELETE": "The HTTP DELETE method.", "HEAD": "The HTTP HEAD method.", "CONNECT": "The HTTP CONNECT method.", "OPTIONS": "The HTTP OPTIONS method.", "PATCH": "The HTTP PATCH method." } } } }, "link_description_list": { "type": "array", "description": "An array of request-related HATEOAS links.", "readOnly": true, "minItems": 1, "maxItems": 10, "items": { "$ref": "#/components/schemas/link_description" } }, "merchant_partner_customer_id": { "type": "string", "description": "The unique ID for a customer generated by PayPal.", "minLength": 1, "maxLength": 22, "pattern": "^[0-9a-zA-Z_-]+$" }, "money": { "type": "object", "title": "Money", "description": "The currency and amount for a financial transaction, such as a balance or payment due.", "properties": { "currency_code": { "$ref": "#/components/schemas/currency_code" }, "value": { "type": "string", "description": "The value, which might be:For the required number of decimal places for a currency code, see [Currency Codes](/api/rest/reference/currency-codes/).", "maxLength": 32, "pattern": "^((-?[0-9]+)|(-?([0-9]+)?[.][0-9]+))$" } }, "required": ["currency_code", "value"] }, "most_recent_error": {}, "most_recent_error_list": { "description": "The error reason code and description that are the reason for the most recent order decline.", "type": "array", "minItems": 1, "maxItems": 10, "items": { "$ref": "#/components/schemas/most_recent_error" } }, "mybank": { "type": "object", "title": "MyBank payment object", "description": "Information used to pay using MyBank.", "properties": { "name": { "description": "The name of the account holder associated with this payment method.", "$ref": "#/components/schemas/full_name" }, "country_code": { "description": "The two-character ISO 3166-1 country code.", "$ref": "#/components/schemas/country_code-2" }, "bic": { "description": "The bank identification code (BIC).", "$ref": "#/components/schemas/bic" }, "iban_last_chars": { "$ref": "#/components/schemas/iban_last_chars" } } }, "mybank_request": { "type": "object", "title": "MyBank payment request", "description": "Information needed to pay using MyBank.", "properties": { "name": { "description": "The name of the account holder associated with this payment method.", "$ref": "#/components/schemas/full_name" }, "country_code": { "description": "The two-character ISO 3166-1 country code.", "$ref": "#/components/schemas/country_code-2" }, "experience_context": { "description": "Customizes the payer experience during the approval process for the payment.", "$ref": "#/components/schemas/experience_context_base" } }, "required": ["name", "country_code"] }, "net_amount_breakdown_item": { "type": "object", "title": "Net Amount Breakdown Item", "description": "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.", "properties": { "payable_amount": { "description": "The net amount debited from the merchant's PayPal account.", "readOnly": true, "$ref": "#/components/schemas/money" }, "converted_amount": { "description": "The converted payable amount.", "readOnly": true, "$ref": "#/components/schemas/money" }, "exchange_rate": { "description": "The exchange rate that determines the amount that was debited from the merchant's PayPal account.", "readOnly": true, "$ref": "#/components/schemas/exchange_rate" } } }, "net_amount_breakdown_item_list": { "type": "array", "description": "An array of breakdown values for the net amount. Returned when the currency of the refund is different from the currency of the PayPal account where the payee holds their funds.", "items": { "$ref": "#/components/schemas/net_amount_breakdown_item" }, "readOnly": true }, "network_token_request": { "type": "object", "title": "Network Token", "description": "The Third Party Network token used to fund a payment.", "properties": { "number": { "type": "string", "description": "Third party network token number.", "pattern": "^[0-9]{13,19}$", "minLength": 13, "maxLength": 19 }, "expiry": { "description": "The card expiration year and month, in [Internet date format](https://tools.ietf.org/html/rfc3339#section-5.6).", "$ref": "#/components/schemas/date_year_month" }, "cryptogram": { "type": "string", "description": "An Encrypted one-time use value that's sent along with Network Token. This field is not required to be present for recurring transactions.", "pattern": "^.*$", "minLength": 28, "maxLength": 32 }, "eci_flag": { "$ref": "#/components/schemas/eci_flag" }, "token_requestor_id": { "type": "string", "description": "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.", "pattern": "^[0-9A-Z_]+$", "minLength": 1, "maxLength": 11 } }, "required": ["number", "expiry"] }, "network_transaction": { "type": "object", "title": "Network Transaction", "description": "Reference values used by the card network to identify a transaction.", "properties": { "id": { "type": "string", "minLength": 9, "maxLength": 36, "pattern": "^[a-zA-Z0-9-_@.:&+=*^'~#!$%()]+$", "description": "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": { "type": "string", "minLength": 4, "maxLength": 4, "pattern": "^[0-9]+$", "description": "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." }, "network": { "description": "Name of the card network through which the transaction was routed.", "$ref": "#/components/schemas/card_brand" }, "acquirer_reference_number": { "type": "string", "description": "Reference ID issued for the card transaction. This ID can be used to track the transaction across processors, card brands and issuing banks.", "minLength": 1, "maxLength": 36, "pattern": "^[a-zA-Z0-9]+$" } } }, "network_transaction_reference": { "type": "object", "title": "Network Transaction Reference", "description": "Reference values used by the card network to identify a transaction.", "allOf": [ { "$ref": "#/components/schemas/network_transaction" } ], "required": ["id"] }, "order": { "type": "object", "title": "Order", "description": "The order details.", "allOf": [ { "$ref": "#/components/schemas/activity_timestamps" }, { "properties": { "id": { "type": "string", "description": "The ID of the order.", "readOnly": true }, "payment_source": { "$ref": "#/components/schemas/payment_source_response" }, "intent": { "$ref": "#/components/schemas/checkout_payment_intent" }, "processing_instruction": { "$ref": "#/components/schemas/processing_instruction" }, "payer": { "$ref": "#/components/schemas/payer", "description": "DEPRECATED. The customer is also known as the payer. The Payer object was intended to only be used with the `payment_source.paypal` object. In order to make this design more clear, the details in the `payer` object are now available under `payment_source.paypal`. Please use `payment_source.paypal`.", "deprecated": true }, "purchase_units": { "$ref": "#/components/schemas/purchase_unit_list" }, "status": { "$ref": "#/components/schemas/order_status", "readOnly": true }, "links": { "$ref": "#/components/schemas/order_definitions-link_description_list" } } } ] }, "order_application_context": { "type": "object", "title": "Order Application Context", "description": "Customizes the payer experience during the approval process for the payment with PayPal.
Note: Partners and Marketplaces might configure brand_name and shipping_preference during partner account setup, which overrides the request values.
", "properties": { "brand_name": { "type": "string", "description": "DEPRECATED. The label that overrides the business name in the PayPal account on the PayPal site. The fields in `application_context` are now available in the `experience_context` object under the `payment_source` which supports them (eg. `payment_source.paypal.experience_context.brand_name`). Please specify this field in the `experience_context` object instead of the `application_context` object.", "minLength": 1, "maxLength": 127 }, "locale": { "description": "DEPRECATED. The BCP 47-formatted locale of pages that the PayPal payment experience shows. PayPal supports a five-character code. For example, `da-DK`, `he-IL`, `id-ID`, `ja-JP`, `no-NO`, `pt-BR`, `ru-RU`, `sv-SE`, `th-TH`, `zh-CN`, `zh-HK`, or `zh-TW`. The fields in `application_context` are now available in the `experience_context` object under the `payment_source` which supports them (eg. `payment_source.paypal.experience_context.locale`). Please specify this field in the `experience_context` object instead of the `application_context` object.", "$ref": "#/components/schemas/language" }, "landing_page": { "title": "Order Application Context Landing Page", "type": "string", "description": "DEPRECATED. DEPRECATED. The type of landing page to show on the PayPal site for customer checkout. The fields in `application_context` are now available in the `experience_context` object under the `payment_source` which supports them (eg. `payment_source.paypal.experience_context.landing_page`). Please specify this field in the `experience_context` object instead of the `application_context` object.", "deprecated": true, "default": "NO_PREFERENCE", "x-enumDescriptions": [ { "value": "LOGIN", "description": "When the customer clicks PayPal Checkout, the customer is redirected to a page to log in to PayPal and approve the payment." }, { "value": "BILLING", "description": "When the customer clicks PayPal Checkout, the customer is redirected to a page to enter credit or debit card and other relevant billing information required to complete the purchase." }, { "value": "NO_PREFERENCE", "description": "When the customer clicks PayPal Checkout, the customer is redirected to either a page to log in to PayPal and approve the payment or to a page to enter credit or debit card and other relevant billing information required to complete the purchase, depending on their previous interaction with PayPal." } ], "minLength": 1, "maxLength": 13, "pattern": "^[0-9A-Z_]+$", "enum": ["LOGIN", "BILLING", "NO_PREFERENCE"] }, "shipping_preference": { "title": "Order Application Context Shipping Preference", "type": "string", "description": "DEPRECATED. DEPRECATED. The shipping preference:. The fields in `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.", "deprecated": true, "default": "GET_FROM_FILE", "x-enumDescriptions": [ { "value": "GET_FROM_FILE", "description": "Use the customer-provided shipping address on the PayPal site.", "default": true }, { "value": "NO_SHIPPING", "description": "Redact the shipping address from the PayPal site. Recommended for digital goods." }, { "value": "SET_PROVIDED_ADDRESS", "description": "Use the merchant-provided address. The customer cannot change this address on the PayPal site." } ], "minLength": 1, "maxLength": 20, "pattern": "^[0-9A-Z_]+$", "enum": ["GET_FROM_FILE", "NO_SHIPPING", "SET_PROVIDED_ADDRESS"] }, "user_action": { "type": "string", "description": "DEPRECATED. Configures a Continue or Pay Now checkout flow. The fields in `application_context` are now available in the `experience_context` object under the `payment_source` which supports them (eg. `payment_source.paypal.experience_context.user_action`). Please specify this field in the `experience_context` object instead of the `application_context` object.", "default": "CONTINUE", "x-enumDescriptions": [ { "value": "CONTINUE", "description": "After you redirect the customer to the PayPal payment page, a Continue button appears. Use this option when the final amount is not known when the checkout flow is initiated and you want to redirect the customer to the merchant page without processing the payment.", "default": true }, { "value": "PAY_NOW", "description": "After you redirect the customer to the PayPal payment page, a Pay Now button appears. Use this option when the final amount is known when the checkout is initiated and you want to process the payment immediately when the customer clicks Pay Now." } ], "minLength": 1, "maxLength": 8, "pattern": "^[0-9A-Z_]+$", "enum": ["CONTINUE", "PAY_NOW"] }, "payment_method": { "description": "DEPRECATED. The customer and merchant payment preferences. The fields in `application_context` are now available in the `experience_context` object under the `payment_source` which supports them (eg. `payment_source.paypal.experience_context.payment_method_selected`). Please specify this field in the `experience_context` object instead of the `application_context` object..", "$ref": "#/components/schemas/payment_method" }, "return_url": { "type": "string", "format": "uri", "description": "DEPRECATED. The URL where the customer is redirected after the customer approves the payment. The fields in `application_context` are now available in the `experience_context` object under the `payment_source` which supports them (eg. `payment_source.paypal.experience_context.return_url`). Please specify this field in the `experience_context` object instead of the `application_context` object." }, "cancel_url": { "type": "string", "format": "uri", "description": "DEPRECATED. The URL where the customer is redirected after the customer cancels the payment. The fields in `application_context` are now available in the `experience_context` object under the `payment_source` which supports them (eg. `payment_source.paypal.experience_context.cancel_url`). Please specify this field in the `experience_context` object instead of the `application_context` object." }, "stored_payment_source": { "description": "DEPRECATED. 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:
. The fields in `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.", "$ref": "#/components/schemas/stored_payment_source", "deprecated": true } } }, "order_authorize_request": { "type": "object", "title": "Order Authorize Request", "description": "The authorization of an order request.", "properties": { "payment_source": { "description": "The payment source definition.", "type": "object", "title": "Payment Source", "properties": { "card": { "$ref": "#/components/schemas/card_request" }, "token": { "$ref": "#/components/schemas/token" }, "paypal": { "description": "Indicates that PayPal Wallet is the payment source. Main use of this selection is to provide additional instructions associated with this choice like vaulting.", "$ref": "#/components/schemas/paypal_wallet" }, "swish": { "description": "The Sweden payment method Swish is an online payment method that enables consumers to pay online through their own bank.", "$ref": "#/components/schemas/swish_request" }, "pix": { "description": "PIX is a local payment method in Brazil, that enables consumers to pay online through their own bank.", "$ref": "#/components/schemas/pix_request" }, "apple_pay": { "description": "ApplePay payment source, allows buyer to pay using ApplePay, both on Web as well as on Native.", "$ref": "#/components/schemas/apple_pay_request" }, "google_pay": { "description": "Google Pay payment source, allows buyer to pay using Google Pay.", "$ref": "#/components/schemas/google_pay_request" }, "venmo": { "description": "Information needed to indicate that Venmo is being used to fund the payment.", "$ref": "#/components/schemas/venmo_wallet_request" } } } } }, "order_authorize_response": { "allOf": [ { "$ref": "#/components/schemas/activity_timestamps" }, {}, { "properties": { "id": { "type": "string", "description": "The ID of the order.", "readOnly": true }, "payment_source": { "type": "object", "title": "Payment Source Response", "description": "The payment source used to fund the payment.", "properties": { "card": { "$ref": "#/components/schemas/card_response" }, "paypal": { "$ref": "#/components/schemas/paypal_wallet_response" }, "swish": { "$ref": "#/components/schemas/swish" }, "apple_pay": { "$ref": "#/components/schemas/apple_pay" }, "google_pay": { "$ref": "#/components/schemas/google_pay" }, "venmo": { "$ref": "#/components/schemas/venmo_wallet_response" }, "pix": { "$ref": "#/components/schemas/pix" }, "crypto": { "$ref": "#/components/schemas/crypto" } } }, "intent": { "$ref": "#/components/schemas/checkout_payment_intent" }, "processing_instruction": { "$ref": "#/components/schemas/processing_instruction" }, "payer": { "$ref": "#/components/schemas/payer" }, "purchase_units": { "$ref": "#/components/schemas/purchase_unit_list" }, "status": { "$ref": "#/components/schemas/order_status", "readOnly": true }, "links": { "$ref": "#/components/schemas/link_description_list" } } }, { "type": "object", "title": "Order Authorize Response", "description": "The order authorize response." } ] }, "order_billing_plan": { "title": "Billing Plan", "description": "Metadata for merchant-managed recurring billing plans. Valid only during the saved payment method token or billing agreement creation.", "type": "object", "properties": { "billing_cycles": { "$ref": "#/components/schemas/billing_cycle_list" }, "setup_fee": { "description": "The setup fee for the recurring plan. Ensure its part of the item amount.", "$ref": "#/components/schemas/money" }, "name": { "type": "string", "description": "Name of the recurring plan.", "minLength": 1, "maxLength": 127, "pattern": "^[A-Za-z0-9() +',.:-]+$" } }, "required": ["billing_cycles"] }, "order_capture_request": { "type": "object", "title": "Order Capture Request", "description": "Completes an capture payment for an order.", "properties": { "payment_source": { "type": "object", "title": "Payment Source", "description": "The payment source definition.", "properties": { "card": { "$ref": "#/components/schemas/card_request" }, "token": { "$ref": "#/components/schemas/token" }, "paypal": { "description": "Indicates that PayPal Wallet is the payment source. Main use of this selection is to provide additional instructions associated with this choice like vaulting.", "$ref": "#/components/schemas/paypal_wallet" }, "swish": { "description": "The Sweden payment method Swish is an online payment method that enables consumers to pay online through their own bank.", "$ref": "#/components/schemas/swish_request" }, "pix": { "description": "PIX is a local payment method in Brazil, that enables consumers to pay online through their own bank.", "$ref": "#/components/schemas/pix_request" }, "apple_pay": { "description": "ApplePay payment source, allows buyer to pay using ApplePay, both on Web as well as on Native.", "$ref": "#/components/schemas/apple_pay_request" }, "google_pay": { "description": "Google Pay payment source, allows buyer to pay using Google Pay.", "$ref": "#/components/schemas/google_pay_request" }, "venmo": { "description": "Information needed to indicate that Venmo is being used to fund the payment.", "$ref": "#/components/schemas/venmo_wallet_request" } } } } }, "order_confirm_application_context": { "type": "object", "title": "Order Confirm Application Context", "description": "Customizes the payer confirmation experience.", "properties": { "brand_name": { "type": "string", "description": "Label to present to your payer as part of the PayPal hosted web experience.", "minLength": 1, "maxLength": 127 }, "locale": { "description": "The BCP 47-formatted locale of pages that the PayPal payment experience shows. PayPal supports a five-character code. For example, `da-DK`, `he-IL`, `id-ID`, `ja-JP`, `no-NO`, `pt-BR`, `ru-RU`, `sv-SE`, `th-TH`, `zh-CN`, `zh-HK`, or `zh-TW`.", "$ref": "#/components/schemas/language" }, "return_url": { "type": "string", "format": "uri", "minLength": 10, "maxLength": 4000, "description": "The URL where the customer is redirected after the customer approves the payment." }, "cancel_url": { "type": "string", "format": "uri", "minLength": 10, "maxLength": 4000, "description": "The URL where the customer is redirected after the customer cancels the payment." }, "stored_payment_source": { "$ref": "#/components/schemas/stored_payment_source" } } }, "order_definitions-link_description_list": { "type": "array", "description": "An array of request-related HATEOAS links. To complete payer approval, use the `approve` link to redirect the payer. The API caller has 6 hours (default setting, this which can be changed by your account manager to 24/48/72 hours to accommodate your use case) from the time the order is created, to redirect your payer. Once redirected, the API caller has 6 hours for the payer to approve the order and either authorize or capture the order. If you are not using the PayPal JavaScript SDK to initiate PayPal Checkout (in context) ensure that you include `application_context.return_url` is specified or you will get \"We're sorry, Things don't appear to be working at the moment\" after the payer approves the payment.", "readOnly": true, "items": { "$ref": "#/components/schemas/link_description" } }, "order_request": { "type": "object", "title": "Order Request", "description": "The order request details.", "properties": { "intent": { "$ref": "#/components/schemas/checkout_payment_intent" }, "payer": { "description": "DEPRECATED. The customer is also known as the payer. The Payer object was intended to only be used with the `payment_source.paypal` object. In order to make this design more clear, the details in the `payer` object are now available under `payment_source.paypal`. Please use `payment_source.paypal`.", "$ref": "#/components/schemas/payer", "deprecated": true }, "purchase_units": { "$ref": "#/components/schemas/purchase_unit_request_list" }, "payment_source": { "$ref": "#/components/schemas/payment_source" }, "application_context": { "description": "Customize the payer experience during the approval process for the payment with PayPal.", "$ref": "#/components/schemas/order_application_context" } }, "required": ["intent", "purchase_units"] }, "order_status": { "type": "string", "description": "The order status.", "title": "Order Status", "minLength": 1, "maxLength": 255, "pattern": "^[0-9A-Z_]+$", "x-enumDescriptions": [ { "value": "CREATED", "description": "The order was created with the specified context." }, { "value": "SAVED", "description": "The order was saved and persisted. The order status continues to be in progress until a capture is made with final_capture = true for all purchase units within the order." }, { "value": "APPROVED", "description": "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." }, { "value": "VOIDED", "description": "All purchase units in the order are voided." }, { "value": "COMPLETED", "description": "The intent of the order was completed and a `payments` resource was created. Important: Check the payment status in `purchase_units[].payments.captures[].status` before fulfilling the order. A completed order can indicate a payment was authorized, an authorized payment was captured, or a payment was declined." }, { "value": "PAYER_ACTION_REQUIRED", "description": "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)." } ], "enum": [ "CREATED", "SAVED", "APPROVED", "VOIDED", "COMPLETED", "PAYER_ACTION_REQUIRED" ] }, "order_tracker_request": { "type": "object", "title": "Order Tracker Request.", "description": "The tracking details of an order.", "properties": { "tracking_number": { "type": "string", "description": "The tracking number for the shipment. This property supports Unicode.", "minLength": 1, "maxLength": 64 }, "carrier": { "$ref": "#/components/schemas/shipment_carrier" }, "carrier_name_other": { "type": "string", "description": "The name of the carrier for the shipment. Provide this value only if the carrier parameter is OTHER. This property supports Unicode.", "minLength": 1, "maxLength": 64 }, "capture_id": { "type": "string", "description": "The PayPal capture ID.", "minLength": 1, "maxLength": 50, "pattern": "^[a-zA-Z0-9]*$" }, "notify_payer": { "type": "boolean", "description": "If true, PayPal will send an email notification to the payer of the PayPal transaction. The email contains the tracking details provided through the Orders tracking API request. Independent of any value passed for `notify_payer`, the payer may receive tracking notifications within the PayPal app, based on the user's notification preferences.", "default": false }, "items": { "$ref": "#/components/schemas/tracker_item_list" } }, "required": ["capture_id"] }, "order_update_callback_request": { "title": "OrderUpdateCallbackRequest", "type": "object", "description": "Shipping Options Callback request. This will be implemented by the merchants.", "properties": { "id": { "type": "string", "description": "The ID of the order.", "readOnly": true, "minLength": 1, "maxLength": 36, "pattern": "^[A-Z0-9-]+$" }, "shipping_address": { "description": "The portable international postal address. Maps to [AddressValidationMetadata](https://github.com/googlei18n/libaddressinput/wiki/AddressValidationMetadata) and HTML 5.1 [Autofilling form controls: the autocomplete attribute](https://www.w3.org/TR/html51/sec-forms.html#autofilling-form-controls-the-autocomplete-attribute).", "type": "object", "title": "Portable Postal Address (Medium-Grained)", "properties": { "admin_area_2": { "type": "string", "description": "A city, town, or village. Smaller than `admin_area_level_1`.", "maxLength": 120 }, "admin_area_1": { "type": "string", "description": "The highest-level sub-division in a country, which is usually a province, state, or ISO-3166-2 subdivision. This data is formatted for postal delivery, for example, `CA` and not `California`. Value, by country, is:", "maxLength": 300 }, "postal_code": { "type": "string", "description": "The postal code, which is the ZIP code or equivalent. Typically required for countries with a postal code or an equivalent. See [postal code](https://en.wikipedia.org/wiki/Postal_code).", "maxLength": 60 }, "country_code": { "$ref": "#/components/schemas/country_code" } }, "required": ["country_code"] }, "shipping_option": { "description": "The options that the payee or merchant offers to the payer to ship or pick up their items.", "type": "object", "title": "Shipping Option", "properties": { "id": { "type": "string", "description": "A unique ID that identifies a payer-selected shipping option.", "maxLength": 127 }, "label": { "type": "string", "description": "A description that the payer sees, which helps them choose an appropriate shipping option. For example, `Free Shipping`, `USPS Priority Shipping`, `Expédition prioritaire USPS`, or `USPS yōuxiān fā huò`. Localize this description to the payer's locale.", "maxLength": 127 }, "type": { "description": "A classification for the method of purchase fulfillment.", "$ref": "#/components/schemas/shipping_type" }, "amount": { "description": "The shipping cost for the selected option.", "$ref": "#/components/schemas/money" } }, "required": ["id", "label"] }, "purchase_units": { "$ref": "#/components/schemas/definitions-purchase_unit_request_list" } }, "required": ["shipping_address", "purchase_units"] }, "order_update_callback_response": { "title": "OrderUpdateCallbackResponse", "description": "Returns the updated shipping options for an order.", "type": "object", "properties": { "id": { "type": "string", "description": "The ID of the order.", "readOnly": true, "minLength": 1, "maxLength": 36, "pattern": "^[A-Z0-9-]+$" }, "purchase_units": { "$ref": "#/components/schemas/shipping_options_purchase_unit" } } }, "orders.authorize-400": { "properties": { "details": { "type": "array", "items": { "anyOf": [ { "title": "INVALID_COUNTRY_CODE", "properties": { "issue": { "type": "string", "enum": ["INVALID_COUNTRY_CODE"] }, "description": { "type": "string", "enum": [ "Country code is invalid. Please refer to https://developer.paypal.com/api/rest/reference/country-codes/ for a list of supported country codes." ] } } }, { "title": "INVALID_PARAMETER_VALUE", "properties": { "issue": { "type": "string", "enum": ["INVALID_PARAMETER_VALUE"] }, "description": { "type": "string", "enum": ["A parameter value is not valid."] } } }, { "title": "MISSING_REQUIRED_PARAMETER", "properties": { "issue": { "type": "string", "enum": ["MISSING_REQUIRED_PARAMETER"] }, "description": { "type": "string", "enum": ["A required field / parameter is missing"] } } }, { "title": "INVALID_STRING_LENGTH", "properties": { "issue": { "type": "string", "enum": ["INVALID_STRING_LENGTH"] }, "description": { "type": "string", "enum": [ "The value of a field is either too short or too long" ] } } }, { "title": "INVALID_PARAMETER_SYNTAX", "properties": { "issue": { "type": "string", "enum": ["INVALID_PARAMETER_SYNTAX"] }, "description": { "type": "string", "enum": [ "The value of a field does not conform to the expected format." ] } } }, { "title": "MALFORMED_REQUEST_JSON", "properties": { "issue": { "type": "string", "enum": ["MALFORMED_REQUEST_JSON"] }, "description": { "type": "string", "enum": ["The request JSON is not well formed."] } } } ] } } } }, "orders.authorize-403": { "properties": { "details": { "type": "array", "items": { "anyOf": [ { "title": "NOT_ELIGIBLE_FOR_TOKEN_PROCESSING", "properties": { "issue": { "type": "string", "enum": ["NOT_ELIGIBLE_FOR_TOKEN_PROCESSING"] }, "description": { "type": "string", "enum": [ "API caller is not enabled to process payments with the specified type of token. Please contact customer support to request permissions to process transactions with this type of token." ] } } }, { "title": "PERMISSION_DENIED", "properties": { "issue": { "type": "string", "enum": ["PERMISSION_DENIED"] }, "description": { "type": "string", "enum": [ "You do not have permission to access or perform operations on this resource." ] } } }, { "title": "PERMISSION_DENIED_FOR_DONATION_ITEMS", "properties": { "issue": { "type": "string", "enum": ["PERMISSION_DENIED_FOR_DONATION_ITEMS"] }, "description": { "type": "string", "enum": [ "The API Caller or Payee have not been granted appropriate permissions to send 'items.category' as 'DONATION'. Please speak to your account manager if you want to process these type of items." ] } } } ] } } } }, "orders.authorize-422": { "properties": { "details": { "type": "array", "items": { "anyOf": [ { "title": "ACTION_DOES_NOT_MATCH_INTENT", "properties": { "issue": { "type": "string", "enum": ["ACTION_DOES_NOT_MATCH_INTENT"] }, "description": { "type": "string", "enum": [ "Order was created with an intent to 'CAPTURE'. Please use v2/checkout/orders/order_id/capture to complete the transaction or alternately Create an order with an intent of 'AUTHORIZE'." ] } } }, { "title": "PREFERRED_BRAND_NOT_SUPPORTED", "properties": { "issue": { "type": "string", "enum": ["PREFERRED_BRAND_NOT_SUPPORTED"] }, "description": { "type": "string", "enum": [ "Processing of this preferred brand is not supported. Please use another brand preference to continue with this transaction." ] } } }, { "title": "AGREEMENT_ALREADY_CANCELLED", "properties": { "issue": { "type": "string", "enum": ["AGREEMENT_ALREADY_CANCELLED"] }, "description": { "type": "string", "enum": ["The requested agreement is already canceled."] } } }, { "title": "BILLING_AGREEMENT_NOT_FOUND", "properties": { "issue": { "type": "string", "enum": ["BILLING_AGREEMENT_NOT_FOUND"] }, "description": { "type": "string", "enum": [ "The requested Billing Agreement token was not found." ] } } }, { "title": "MISSING_PREVIOUS_REFERENCE", "properties": { "issue": { "type": "string", "enum": ["MISSING_PREVIOUS_REFERENCE"] }, "description": { "type": "string", "enum": [ "For Merchant initiated network token transactions, either the payment_source.card.stored_credential.previous_network_transaction_reference or payment_source.card.stored_credential.previous_transaction_reference must be included in the request." ] } } }, { "title": "MISSING_CRYPTOGRAM", "properties": { "issue": { "type": "string", "enum": ["MISSING_CRYPTOGRAM"] }, "description": { "type": "string", "enum": [ "Cryptogram is mandatory for any customer initiated network token transactions." ] } } }, { "title": "CARD_BRAND_NOT_SUPPORTED", "properties": { "issue": { "type": "string", "enum": ["CARD_BRAND_NOT_SUPPORTED"] }, "description": { "type": "string", "enum": [ "Processing of this card brand is not supported. Please use another card to continue with this transaction." ] } } }, { "title": "CARD_COUNTRY_NOT_SUPPORTED", "properties": { "issue": { "type": "string", "enum": ["CARD_COUNTRY_NOT_SUPPORTED"] }, "description": { "type": "string", "enum": [ "The country in which this card was issued is not currently supported. Please use another card to continue with this transaction." ] } } }, { "title": "CARD_DATA_NOT_FOUND", "properties": { "issue": { "type": "string", "enum": ["CARD_DATA_NOT_FOUND"] }, "description": { "type": "string", "enum": [ "The card issuer data information could not be retrieved. Please use a different card to proceed with this transaction." ] } } }, { "title": "DECLINED_DUE_TO_RELATED_TXN", "properties": { "issue": { "type": "string", "enum": ["DECLINED_DUE_TO_RELATED_TXN"] }, "description": { "type": "string", "enum": [ "One or more transactions in this Order did not succeed. Since this Order is being processed as an All or None Order, if one or more transactions in this Order do not succeed, then all purchase units are marked declined and will not be processed." ] } } }, { "title": "DOMESTIC_TRANSACTION_REQUIRED", "properties": { "issue": { "type": "string", "enum": ["DOMESTIC_TRANSACTION_REQUIRED"] }, "description": { "type": "string", "enum": [ "This transaction requires the payee and payer to be resident in the same country, a domestic transaction is required to create this payment." ] } } }, { "title": "DUPLICATE_INVOICE_ID", "properties": { "issue": { "type": "string", "enum": ["DUPLICATE_INVOICE_ID"] }, "description": { "type": "string", "enum": [ "Duplicate Invoice ID detected. To avoid a potential duplicate transaction your account setting requires that Invoice Id be unique for each transaction." ] } } }, { "title": "ORDER_NOT_APPROVED", "properties": { "issue": { "type": "string", "enum": ["ORDER_NOT_APPROVED"] }, "description": { "type": "string", "enum": [ "Payer has not yet approved the Order for payment. Please redirect the payer to the 'rel':'approve' url returned as part of the HATEOAS links within the Create Order call." ] } } }, { "title": "MAX_NUMBER_OF_PAYMENT_ATTEMPTS_EXCEEDED", "properties": { "issue": { "type": "string", "enum": ["MAX_NUMBER_OF_PAYMENT_ATTEMPTS_EXCEEDED"] }, "description": { "type": "string", "enum": [ "You have exceeded the maximum number of payment attempts." ] } } }, { "title": "PAYEE_BLOCKED_TRANSACTION", "properties": { "issue": { "type": "string", "enum": ["PAYEE_BLOCKED_TRANSACTION"] }, "description": { "type": "string", "enum": [ "Declined by fraud tool (Fraud Protection/Chargeback Protection) due to potential fraud risk. Please review your fraud settings." ] } } }, { "title": "CONTINGENCY_NOT_SUCCESSFUL", "properties": { "issue": { "type": "string", "enum": ["CONTINGENCY_NOT_SUCCESSFUL"] }, "description": { "type": "string", "enum": [ "3D-Secure payer authentication is unsuccessful, so the payment cannot be completed." ] } } }, { "title": "PAYEE_FX_RATE_ID_EXPIRED", "properties": { "issue": { "type": "string", "enum": ["PAYEE_FX_RATE_ID_EXPIRED"] }, "description": { "type": "string", "enum": [ "The specified FX Rate ID has expired. Please specify a different FX Rate Id and try the request again. Alternately, remove the FX Rate ID to process the request using the default exchange rate." ] } } }, { "title": "UNSUPPORTED_INTENT_FOR_PAYMENT_SOURCE", "properties": { "issue": { "type": "string", "enum": ["UNSUPPORTED_INTENT_FOR_PAYMENT_SOURCE"] }, "description": { "type": "string", "enum": [ "`intent=AUTHORIZE` is not supported for the specified payment_source. Only `intent=CAPTURE` is supported." ] } } }, { "title": "INELIGIBLE_SHIPPING_OPTION", "properties": { "issue": { "type": "string", "enum": ["INELIGIBLE_SHIPPING_OPTION"] }, "description": { "type": "string", "enum": [ "One or more shipping options cannot be used in conjunction with this Order." ] } } }, { "title": "PAYER_ACCOUNT_LOCKED_OR_CLOSED", "properties": { "issue": { "type": "string", "enum": ["PAYER_ACCOUNT_LOCKED_OR_CLOSED"] }, "description": { "type": "string", "enum": [ "The payer account cannot be used for this transaction." ] } } }, { "title": "PAYER_ACCOUNT_RESTRICTED", "properties": { "issue": { "type": "string", "enum": ["PAYER_ACCOUNT_RESTRICTED"] }, "description": { "type": "string", "enum": ["PAYER_ACCOUNT_RESTRICTED"] } } }, { "title": "PAYMENT_ORIGIN_NOT_ENABLED", "properties": { "issue": { "type": "string", "enum": ["PAYMENT_ORIGIN_NOT_ENABLED"] }, "description": { "type": "string", "enum": [ "The API caller account or payee is not enabled for the given 'payment_origin' option. Please contact customer support for assistance." ] } } }, { "title": "PAYER_CANNOT_PAY", "properties": { "issue": { "type": "string", "enum": ["PAYER_CANNOT_PAY"] }, "description": { "type": "string", "enum": [ "Payer cannot pay for this transaction. Please contact the payer to find other ways to pay for this transaction." ] } } }, { "title": "PAYPAL_TRANSACTION_ID_EXPIRED", "properties": { "issue": { "type": "string", "enum": ["PAYPAL_TRANSACTION_ID_EXPIRED"] }, "description": { "type": "string", "enum": [ "Specified `paypal_transaction_id` has expired. PayPal transaction ID expires 4 years after the date of the initial transaction." ] } } }, { "title": "PNREF_EXPIRED", "properties": { "issue": { "type": "string", "enum": ["PNREF_EXPIRED"] }, "description": { "type": "string", "enum": [ "Specified `pnref` has expired. PNREF expires 15 months after the date of the initial transaction." ] } } }, { "title": "PAYMENT_DENIED", "properties": { "issue": { "type": "string", "enum": ["PAYMENT_DENIED"] }, "description": { "type": "string", "enum": [ "PayPal has declined to process this transaction." ] } } }, { "title": "REFERENCED_CARD_EXPIRED", "properties": { "issue": { "type": "string", "enum": ["REFERENCED_CARD_EXPIRED"] }, "description": { "type": "string", "enum": [ "The card underlying the token has expired and hence cannot be used to process a payment." ] } } }, { "title": "TOKEN_EXPIRED", "properties": { "issue": { "type": "string", "enum": ["TOKEN_EXPIRED"] }, "description": { "type": "string", "enum": [ "The token is expired and cannot be used for payment." ] } } }, { "title": "TOKEN_ID_NOT_FOUND", "properties": { "issue": { "type": "string", "enum": ["TOKEN_ID_NOT_FOUND"] }, "description": { "type": "string", "enum": [ "Specified token was not found. Verify the token and try the request again." ] } } }, { "title": "TRANSACTION_LIMIT_EXCEEDED", "properties": { "issue": { "type": "string", "enum": ["TRANSACTION_LIMIT_EXCEEDED"] }, "description": { "type": "string", "enum": [ "Total payment amount exceeded transaction limit." ] } } }, { "title": "TRANSACTION_RECEIVING_LIMIT_EXCEEDED", "properties": { "issue": { "type": "string", "enum": ["TRANSACTION_RECEIVING_LIMIT_EXCEEDED"] }, "description": { "type": "string", "enum": [ "The transaction exceeds the receiver's receiving limit." ] } } }, { "title": "TRANSACTION_REFUSED", "properties": { "issue": { "type": "string", "enum": ["TRANSACTION_REFUSED"] }, "description": { "type": "string", "enum": ["The request was refused."] } } }, { "title": "ORDER_ALREADY_AUTHORIZED", "properties": { "issue": { "type": "string", "enum": ["ORDER_ALREADY_AUTHORIZED"] }, "description": { "type": "string", "enum": [ "Order already authorized.If 'intent=AUTHORIZE' only one authorization per order is allowed." ] } } }, { "title": "AUTH_CAPTURE_NOT_ENABLED", "properties": { "issue": { "type": "string", "enum": ["AUTH_CAPTURE_NOT_ENABLED"] }, "description": { "type": "string", "enum": [ "Authorization and Capture feature is not enabled for the merchant. Make sure that the recipient of the funds is a verified business account." ] } } }, { "title": "AMOUNT_CANNOT_BE_SPECIFIED", "properties": { "issue": { "type": "string", "enum": ["AMOUNT_CANNOT_BE_SPECIFIED"] }, "description": { "type": "string", "enum": [ "An authorization amount can only be specified if an Order has been saved by calling /v2/checkout/orders/{order_id}/save. Please save the order and try again." ] } } }, { "title": "AUTHORIZATION_AMOUNT_EXCEEDED", "properties": { "issue": { "type": "string", "enum": ["AUTHORIZATION_AMOUNT_EXCEEDED"] }, "description": { "type": "string", "enum": [ "Authorization amount specified exceeded allowable limit. Specify a different amount and try the request again. Alternately, contact Customer Support to increase your limits. Local regulations (e.g. in PSD2 countries) prohibit overages above the amount authorized by the payer." ] } } }, { "title": "AUTHORIZATION_CURRENCY_MISMATCH", "properties": { "issue": { "type": "string", "enum": ["AUTHORIZATION_CURRENCY_MISMATCH"] }, "description": { "type": "string", "enum": [ "The currency of the authorization should be same as that in which the Order was created and approved by the Payer. Please check the 'currency_code' and try again." ] } } }, { "title": "MAX_AUTHORIZATION_COUNT_EXCEEDED", "properties": { "issue": { "type": "string", "enum": ["MAX_AUTHORIZATION_COUNT_EXCEEDED"] }, "description": { "type": "string", "enum": [ "Maximum number of authorization allowed for the order is reached. Please contact Customer Support if you need to increase your limit." ] } } }, { "title": "ORDER_COMPLETED_OR_VOIDED", "properties": { "issue": { "type": "string", "enum": ["ORDER_COMPLETED_OR_VOIDED"] }, "description": { "type": "string", "enum": [ "Order is voided or completed and hence cannot be authorized." ] } } }, { "title": "ORDER_EXPIRED", "properties": { "issue": { "type": "string", "enum": ["ORDER_EXPIRED"] }, "description": { "type": "string", "enum": [ "Order is expired and hence cannot be authorized. Please contact Customer Support if you need to increase your order validity period." ] } } }, { "title": "INVALID_PICKUP_ADDRESS", "properties": { "issue": { "type": "string", "enum": ["INVALID_PICKUP_ADDRESS"] }, "description": { "type": "string", "enum": [ "If the 'shipping_option.type' is set as 'PICKUP' then the 'shipping_detail.name.full_name' should start with 'S2S' meaning Ship To Store. Example: 'S2S My Store'." ] } } }, { "title": "SHIPPING_ADDRESS_INVALID", "properties": { "issue": { "type": "string", "enum": ["SHIPPING_ADDRESS_INVALID"] }, "description": { "type": "string", "enum": ["Provided shipping address is invalid."] } } }, { "title": "PAYMENT_TYPE_NOT_SUPPORTED_FOR_INTENT", "properties": { "issue": { "type": "string", "enum": ["PAYMENT_TYPE_NOT_SUPPORTED_FOR_INTENT"] }, "description": { "type": "string", "enum": [ "Provided payment type not supported for order intent. Payment authorizations are supported only for order with `intent=AUTHORIZE` and payment captures are supported only for order with `intent=CAPTURE`." ] } } }, { "title": "BILLING_AGREEMENT_ID_MISMATCH", "properties": { "issue": { "type": "string", "enum": ["BILLING_AGREEMENT_ID_MISMATCH"] }, "description": { "type": "string", "enum": [ "Billing Agreement ID must exactly match the Billing Agreement ID that was provided during order creation." ] } } }, { "title": "PREFERRED_PAYMENT_SOURCE_MISMATCH", "properties": { "issue": { "type": "string", "enum": ["PREFERRED_PAYMENT_SOURCE_MISMATCH"] }, "description": { "type": "string", "enum": [ "Payment Source must exactly match the Preferred Payment Source that was provided during order creation." ] } } }, { "title": "INCOMPATIBLE_PARAMETER_VALUE", "properties": { "issue": { "type": "string", "enum": ["INCOMPATIBLE_PARAMETER_VALUE"] }, "description": { "type": "string", "enum": [ "The value of the field is incompatible/redundant with other fields in the order." ] } } }, { "title": "INVALID_PREVIOUS_TRANSACTION_REFERENCE", "properties": { "issue": { "type": "string", "enum": ["INVALID_PREVIOUS_TRANSACTION_REFERENCE"] }, "description": { "type": "string", "enum": [ "The authorization or capture referenced by `previous_transaction_reference` is not valid. This could be either because the previous_transaction_reference is not found or doesn't belong to the payee. Please use a valid `previous_transaction_reference`." ] } } }, { "title": "PREVIOUS_TRANSACTION_REFERENCE_HAS_CHARGEBACK", "properties": { "issue": { "type": "string", "enum": ["PREVIOUS_TRANSACTION_REFERENCE_HAS_CHARGEBACK"] }, "description": { "type": "string", "enum": [ "The capture referenced by `previous_transaction_reference` has a chargeback and hence cannot be used for this order. Please use a `previous_transaction_reference` which does not have a chargeback." ] } } }, { "title": "PREVIOUS_TRANSACTION_REFERENCE_VOIDED", "properties": { "issue": { "type": "string", "enum": ["PREVIOUS_TRANSACTION_REFERENCE_VOIDED"] }, "description": { "type": "string", "enum": [ "The status of authorization referenced by `previous_transaction_reference` is `VOIDED` and hence cannot be used for this order. Please use a `previous_transaction_reference` whose status is not `VOIDED`." ] } } }, { "title": "PAYMENT_SOURCE_MISMATCH", "properties": { "issue": { "type": "string", "enum": ["PAYMENT_SOURCE_MISMATCH"] }, "description": { "type": "string", "enum": [ "The `payment_source` in the request must match the `payment_source` used for the authorization or capture referenced by `previous_transaction_reference`. Please use `previous_transaction_reference` whose `payment_source` matches with the `payment_source` specified in the order." ] } } }, { "title": "MERCHANT_INITIATED_WITH_SECURITY_CODE", "properties": { "issue": { "type": "string", "enum": ["MERCHANT_INITIATED_WITH_SECURITY_CODE"] }, "description": { "type": "string", "enum": [ "`stored_payment_source.payment_initiator` = `MERCHANT` is not supported if `payment_source.card.security_code` is present in the order. `security_code` can be present in the order only when customer is the payment initiator. It is semantically incorrect to perform a merchant initiated payment with `security_code` is the order." ] } } }, { "title": "MERCHANT_INITIATED_WITH_AUTHENTICATION_RESULTS", "properties": { "issue": { "type": "string", "enum": ["MERCHANT_INITIATED_WITH_AUTHENTICATION_RESULTS"] }, "description": { "type": "string", "enum": [ "`stored_payment_source.payment_initiator` = `MERCHANT` is not supported if 3D-Secure authentication results are present in the order. 3D-Secure authentication results can be present in the order only when customer is the payment initiator. It is semantically incorrect to perform a merchant initiated payment with 3D-Secure authentication results is the order." ] } } }, { "title": "MERCHANT_INITIATED_WITH_MULTIPLE_PURCHASE_UNITS", "properties": { "issue": { "type": "string", "enum": [ "MERCHANT_INITIATED_WITH_MULTIPLE_PURCHASE_UNITS" ] }, "description": { "type": "string", "enum": [ "`stored_payment_source.payment_initiator` = `MERCHANT` is not supported if more than one purchase_unit is present in the Order. Merchant initiated payments are not supported from orders with more than one purchase_unit. Please retry the request with multiple Order requests (one for each purchase_unit)." ] } } }, { "title": "RETURN_URL_REQUIRED", "properties": { "issue": { "type": "string", "enum": ["RETURN_URL_REQUIRED"] }, "description": { "type": "string", "enum": [ "The return url is required when attempting to vault this source." ] } } }, { "title": "CANCEL_URL_REQUIRED", "properties": { "issue": { "type": "string", "enum": ["CANCEL_URL_REQUIRED"] }, "description": { "type": "string", "enum": [ "The cancel url is required when attempting to vault this source." ] } } }, { "title": "PAYER_ACTION_REQUIRED", "properties": { "issue": { "type": "string", "enum": ["PAYER_ACTION_REQUIRED"] }, "description": { "type": "string", "enum": [ "Transaction cannot complete successfully, instruct the buyer to return to PayPal." ] } } }, { "title": "APPLE_PAY_AMOUNT_MISMATCH", "properties": { "issue": { "type": "string", "enum": ["APPLE_PAY_AMOUNT_MISMATCH"] }, "description": { "type": "string", "enum": [ "The 'amount' specified in the Order should match the amount that was viewed and authorized by the payer/buyer on Apple Pay. If the amount has changed, please redirect the buyer to authorize the order again via Apple Pay." ] } } }, { "title": "CARD_NUMBER_REQUIRED", "properties": { "issue": { "type": "string", "enum": ["CARD_NUMBER_REQUIRED"] }, "description": { "type": "string", "enum": [ "The card number is required when attempting to process payment with card." ] } } }, { "title": "CARD_EXPIRY_REQUIRED", "properties": { "issue": { "type": "string", "enum": ["CARD_EXPIRY_REQUIRED"] }, "description": { "type": "string", "enum": [ "The card expiry is required when attempting to process payment with card." ] } } }, { "title": "VAULT_INSTRUCTION_REQUIRED", "properties": { "issue": { "type": "string", "enum": ["VAULT_INSTRUCTION_REQUIRED"] }, "description": { "type": "string", "enum": [ "Vault instruction is required. Please use `vault.store_in_vault` to provide vault instruction." ] } } }, { "title": "MISMATCHED_VAULT_OWNER_ID", "properties": { "issue": { "type": "string", "enum": ["MISMATCHED_VAULT_OWNER_ID"] }, "description": { "type": "string", "enum": [ "The owner_id does not match with the API caller. Please verify that the owner_id is same as the API caller's payer id." ] } } }, { "title": "VAULT_OWNER_ID_NOT_SUPPORTED", "properties": { "issue": { "type": "string", "enum": ["VAULT_OWNER_ID_NOT_SUPPORTED"] }, "description": { "type": "string", "enum": [ "API caller is not enabled to specify the vault owner_id explicitly. Please contact account manager to enable the functionality." ] } } }, { "title": "MISMATCHED_VAULT_ID_TO_PAYMENT_SOURCE", "properties": { "issue": { "type": "string", "enum": ["MISMATCHED_VAULT_ID_TO_PAYMENT_SOURCE"] }, "description": { "type": "string", "enum": [ "The vault_id does not match the payment_source provided. Please verify that the vault_id token used refers to the matching payment_source and try again. For example, a PayPal token cannot be passed in the vault_id field in the payment_source.card object." ] } } }, { "title": "ORDER_CANNOT_BE_SAVED", "properties": { "issue": { "type": "string", "enum": ["ORDER_CANNOT_BE_SAVED"] }, "description": { "type": "string", "enum": [ "The option to save an order is only available if the `intent` is AUTHORIZE and `processing_instruction` uses one of the `ORDER_SAVED` options. For example, `intent`=AUTHORIZE, `processing_instruction`=ORDER_SAVED_EXPLICITLY. Please change the intent and/or processing_instruction` and try again." ] } } }, { "title": "SAVE_ORDER_NOT_SUPPORTED", "properties": { "issue": { "type": "string", "enum": ["SAVE_ORDER_NOT_SUPPORTED"] }, "description": { "type": "string", "enum": [ "The API caller account is setup in a way that does not allow it to be used for saving the order. This functionality is not available for PayPal Complete Payments Platform for Platforms & Marketplaces." ] } } }, { "title": "NOT_ELIGIBLE_FOR_PNREF_PROCESSING", "properties": { "issue": { "type": "string", "enum": ["NOT_ELIGIBLE_FOR_PNREF_PROCESSING"] }, "description": { "type": "string", "enum": [ "API caller is not enabled to process payments with the `pnref`. Please contact customer support to request permissions to process transactions with PNREF." ] } } }, { "title": "NOT_ELIGIBLE_FOR_PAYPAL_TRANSACTION_ID_PROCESSING", "properties": { "issue": { "type": "string", "enum": [ "NOT_ELIGIBLE_FOR_PAYPAL_TRANSACTION_ID_PROCESSING" ] }, "description": { "type": "string", "enum": [ "API caller is not enable to process payments using `paypal_transaction_id`. Please contact customer support to request permissions to process transactions with PayPal transaction ID." ] } } }, { "title": "PAYPAL_TRANSACTION_ID_NOT_FOUND", "properties": { "issue": { "type": "string", "enum": ["PAYPAL_TRANSACTION_ID_NOT_FOUND"] }, "description": { "type": "string", "enum": [ "Specified `paypal_transaction_id` was not found. Verify the value and try the request again." ] } } }, { "title": "PNREF_NOT_FOUND", "properties": { "issue": { "type": "string", "enum": ["PNREF_NOT_FOUND"] }, "description": { "type": "string", "enum": [ "Specified `pnref` was not found. Verify the value and try the request again." ] } } }, { "title": "INVALID_SECURITY_CODE_LENGTH", "properties": { "issue": { "type": "string", "enum": ["INVALID_SECURITY_CODE_LENGTH"] }, "description": { "type": "string", "enum": [ "The security_code length is invalid for the specified card brand." ] } } }, { "title": "REQUIRED_PARAMETER_FOR_CUSTOMER_INITIATED_PAYMENT", "properties": { "issue": { "type": "string", "enum": [ "REQUIRED_PARAMETER_FOR_CUSTOMER_INITIATED_PAYMENT" ] }, "description": { "type": "string", "enum": [ "This parameter is required when the customer is present. If the customer is not present, indicate so by sending payment_initiator=`MERCHANT`. For details, see Stored Credential." ] } } }, { "title": "INVALID_VAULT_ID", "properties": { "issue": { "type": "string", "enum": ["INVALID_VAULT_ID"] }, "description": { "type": "string", "enum": [ "The specified Vault ID is invalid or could not be found." ] } } }, { "title": "ORDER_AUTHORIZATION_IN_PROGRESS", "properties": { "issue": { "type": "string", "enum": ["ORDER_AUTHORIZATION_IN_PROGRESS"] }, "description": { "type": "string", "enum": [ "The `processing_instruction` sent with the selected `payment_source` was `ORDER_COMPLETE_ON_PAYMENT_APPROVAL`, resulting in auto-authorization. Merchant initiated authorization is not allowed." ] } } } ] } } } }, "orders.capture-400": { "properties": { "details": { "type": "array", "items": { "anyOf": [ { "title": "INVALID_PARAMETER_VALUE", "properties": { "issue": { "type": "string", "enum": ["INVALID_PARAMETER_VALUE"] }, "description": { "type": "string", "enum": ["A parameter value is not valid."] } } }, { "title": "MISSING_REQUIRED_PARAMETER", "properties": { "issue": { "type": "string", "enum": ["MISSING_REQUIRED_PARAMETER"] }, "description": { "type": "string", "enum": ["A required field / parameter is missing"] } } }, { "title": "INVALID_STRING_LENGTH", "properties": { "issue": { "type": "string", "enum": ["INVALID_STRING_LENGTH"] }, "description": { "type": "string", "enum": [ "The value of a field is either too short or too long" ] } } }, { "title": "INVALID_PARAMETER_SYNTAX", "properties": { "issue": { "type": "string", "enum": ["INVALID_PARAMETER_SYNTAX"] }, "description": { "type": "string", "enum": [ "The value of a field does not conform to the expected format." ] } } }, { "title": "MALFORMED_REQUEST_JSON", "properties": { "issue": { "type": "string", "enum": ["MALFORMED_REQUEST_JSON"] }, "description": { "type": "string", "enum": ["The request JSON is not well formed."] } } } ] } } } }, "orders.capture-403": { "properties": { "details": { "type": "array", "items": { "anyOf": [ { "title": "CONSENT_NEEDED", "properties": { "issue": { "type": "string", "enum": ["CONSENT_NEEDED"] }, "description": { "type": "string", "enum": ["CONSENT_NEEDED"] } } }, { "title": "NOT_ELIGIBLE_FOR_TOKEN_PROCESSING", "properties": { "issue": { "type": "string", "enum": ["NOT_ELIGIBLE_FOR_TOKEN_PROCESSING"] }, "description": { "type": "string", "enum": [ "API caller is not enabled to process payments with the specified type of token. Please contact customer support to request permissions to process transactions with this type of token." ] } } }, { "title": "PERMISSION_DENIED", "properties": { "issue": { "type": "string", "enum": ["PERMISSION_DENIED"] }, "description": { "type": "string", "enum": [ "You do not have permission to access or perform operations on this resource." ] } } }, { "title": "PERMISSION_DENIED_FOR_DONATION_ITEMS", "properties": { "issue": { "type": "string", "enum": ["PERMISSION_DENIED_FOR_DONATION_ITEMS"] }, "description": { "type": "string", "enum": [ "The API Caller or Payee have not been granted appropriate permissions to send 'items.category' as 'DONATION'. Please speak to your account manager if you want to process these type of items." ] } } } ] } } } }, "orders.capture-422": { "properties": { "details": { "type": "array", "items": { "anyOf": [ { "title": "AGREEMENT_ALREADY_CANCELLED", "properties": { "issue": { "type": "string", "enum": ["AGREEMENT_ALREADY_CANCELLED"] }, "description": { "type": "string", "enum": ["The requested agreement is already canceled."] } } }, { "title": "PREFERRED_BRAND_NOT_SUPPORTED", "properties": { "issue": { "type": "string", "enum": ["PREFERRED_BRAND_NOT_SUPPORTED"] }, "description": { "type": "string", "enum": [ "Processing of this preferred brand is not supported. Please use another brand preference to continue with this transaction." ] } } }, { "title": "BILLING_AGREEMENT_NOT_FOUND", "properties": { "issue": { "type": "string", "enum": ["BILLING_AGREEMENT_NOT_FOUND"] }, "description": { "type": "string", "enum": [ "The requested Billing Agreement token was not found." ] } } }, { "title": "DECLINED_DUE_TO_RELATED_TXN", "properties": { "issue": { "type": "string", "enum": ["DECLINED_DUE_TO_RELATED_TXN"] }, "description": { "type": "string", "enum": [ "One or more transactions in this Order did not succeed. Since this Order is being processed as an All or None Order, if one or more transactions in this Order do not succeed, then all purchase units are marked declined and will not be processed." ] } } }, { "title": "MISSING_PREVIOUS_REFERENCE", "properties": { "issue": { "type": "string", "enum": ["MISSING_PREVIOUS_REFERENCE"] }, "description": { "type": "string", "enum": [ "For Merchant initiated network token transactions, either the payment_source.card.stored_credential.previous_network_transaction_reference or payment_source.card.stored_credential.previous_transaction_reference must be included in the request." ] } } }, { "title": "MISSING_CRYPTOGRAM", "properties": { "issue": { "type": "string", "enum": ["MISSING_CRYPTOGRAM"] }, "description": { "type": "string", "enum": [ "Cryptogram is mandatory for any customer initiated network token transactions." ] } } }, { "title": "CARD_BRAND_NOT_SUPPORTED", "properties": { "issue": { "type": "string", "enum": ["CARD_BRAND_NOT_SUPPORTED"] }, "description": { "type": "string", "enum": [ "Processing of this card brand is not supported. Please use another card to continue with this transaction." ] } } }, { "title": "CARD_COUNTRY_NOT_SUPPORTED", "properties": { "issue": { "type": "string", "enum": ["CARD_COUNTRY_NOT_SUPPORTED"] }, "description": { "type": "string", "enum": [ "The country in which this card was issued is not currently supported. Please use another card to continue with this transaction." ] } } }, { "title": "CARD_DATA_NOT_FOUND", "properties": { "issue": { "type": "string", "enum": ["CARD_DATA_NOT_FOUND"] }, "description": { "type": "string", "enum": [ "The card issuer data information could not be retrieved. Please use a different card to proceed with this transaction." ] } } }, { "title": "COMPLIANCE_VIOLATION", "properties": { "issue": { "type": "string", "enum": ["COMPLIANCE_VIOLATION"] }, "description": { "type": "string", "enum": [ "Transaction is declined due to compliance violation." ] } } }, { "title": "DOMESTIC_TRANSACTION_REQUIRED", "properties": { "issue": { "type": "string", "enum": ["DOMESTIC_TRANSACTION_REQUIRED"] }, "description": { "type": "string", "enum": [ "This transaction requires the payee and payer to be resident in the same country, a domestic transaction is required to create this payment." ] } } }, { "title": "DUPLICATE_INVOICE_ID", "properties": { "issue": { "type": "string", "enum": ["DUPLICATE_INVOICE_ID"] }, "description": { "type": "string", "enum": [ "Duplicate Invoice ID detected. To avoid a potential duplicate transaction your account setting requires that Invoice Id be unique for each transaction." ] } } }, { "title": "INSTRUMENT_DECLINED", "properties": { "issue": { "type": "string", "enum": ["INSTRUMENT_DECLINED"] }, "description": { "type": "string", "enum": [ "The instrument presented was either declined by the processor or bank, or it can't be used for this payment." ] } } }, { "title": "ORDER_NOT_APPROVED", "properties": { "issue": { "type": "string", "enum": ["ORDER_NOT_APPROVED"] }, "description": { "type": "string", "enum": [ "Payer has not yet approved the Order for payment. Please redirect the payer to the 'rel':'approve' url returned as part of the HATEOAS links within the Create Order call or provide a valid `payment_source` in the request." ] } } }, { "title": "MAX_NUMBER_OF_PAYMENT_ATTEMPTS_EXCEEDED", "properties": { "issue": { "type": "string", "enum": ["MAX_NUMBER_OF_PAYMENT_ATTEMPTS_EXCEEDED"] }, "description": { "type": "string", "enum": [ "You have exceeded the maximum number of payment attempts." ] } } }, { "title": "PAYEE_BLOCKED_TRANSACTION", "properties": { "issue": { "type": "string", "enum": ["PAYEE_BLOCKED_TRANSACTION"] }, "description": { "type": "string", "enum": [ "Declined by fraud tool (Fraud Protection/Chargeback Protection) due to potential fraud risk. Please review your fraud settings." ] } } }, { "title": "CONTINGENCY_NOT_SUCCESSFUL", "properties": { "issue": { "type": "string", "enum": ["CONTINGENCY_NOT_SUCCESSFUL"] }, "description": { "type": "string", "enum": [ "3D-Secure payer authentication is unsuccessful, so the payment cannot be completed." ] } } }, { "title": "PAYEE_FX_RATE_ID_EXPIRED", "properties": { "issue": { "type": "string", "enum": ["PAYEE_FX_RATE_ID_EXPIRED"] }, "description": { "type": "string", "enum": [ "The specified FX Rate ID has expired. Please specify a different FX Rate Id and try the request again. Alternately, remove the FX Rate ID to process the request using the default exchange rate." ] } } }, { "title": "PAYER_ACCOUNT_LOCKED_OR_CLOSED", "properties": { "issue": { "type": "string", "enum": ["PAYER_ACCOUNT_LOCKED_OR_CLOSED"] }, "description": { "type": "string", "enum": [ "The payer account cannot be used for this transaction." ] } } }, { "title": "PAYER_ACCOUNT_RESTRICTED", "properties": { "issue": { "type": "string", "enum": ["PAYER_ACCOUNT_RESTRICTED"] }, "description": { "type": "string", "enum": ["PAYER_ACCOUNT_RESTRICTED"] } } }, { "title": "PAYMENT_ORIGIN_NOT_ENABLED", "properties": { "issue": { "type": "string", "enum": ["PAYMENT_ORIGIN_NOT_ENABLED"] }, "description": { "type": "string", "enum": [ "The API caller account or payee is not enabled for the given 'payment_origin' option. Please contact customer support for assistance." ] } } }, { "title": "PAYER_CANNOT_PAY", "properties": { "issue": { "type": "string", "enum": ["PAYER_CANNOT_PAY"] }, "description": { "type": "string", "enum": [ "Payer cannot pay for this transaction. Please contact the payer to find other ways to pay for this transaction." ] } } }, { "title": "PAYPAL_TRANSACTION_ID_EXPIRED", "properties": { "issue": { "type": "string", "enum": ["PAYPAL_TRANSACTION_ID_EXPIRED"] }, "description": { "type": "string", "enum": [ "Specified `paypal_transaction_id` has expired. PayPal transaction ID expires 4 years after the date of the initial transaction." ] } } }, { "title": "PNREF_EXPIRED", "properties": { "issue": { "type": "string", "enum": ["PNREF_EXPIRED"] }, "description": { "type": "string", "enum": [ "Specified `pnref` has expired. PNREF expires 15 months after the date of the initial transaction." ] } } }, { "title": "PAYMENT_DENIED", "properties": { "issue": { "type": "string", "enum": ["PAYMENT_DENIED"] }, "description": { "type": "string", "enum": [ "PayPal has declined to process this transaction." ] } } }, { "title": "REFERENCED_CARD_EXPIRED", "properties": { "issue": { "type": "string", "enum": ["REFERENCED_CARD_EXPIRED"] }, "description": { "type": "string", "enum": [ "The card underlying the token has expired and hence cannot be used to process a payment." ] } } }, { "title": "TOKEN_ID_NOT_FOUND", "properties": { "issue": { "type": "string", "enum": ["TOKEN_ID_NOT_FOUND"] }, "description": { "type": "string", "enum": [ "Specified token was not found. Verify the token and try the request again." ] } } }, { "title": "TRANSACTION_LIMIT_EXCEEDED", "properties": { "issue": { "type": "string", "enum": ["TRANSACTION_LIMIT_EXCEEDED"] }, "description": { "type": "string", "enum": [ "Total payment amount exceeded transaction limit." ] } } }, { "title": "TRANSACTION_RECEIVING_LIMIT_EXCEEDED", "properties": { "issue": { "type": "string", "enum": ["TRANSACTION_RECEIVING_LIMIT_EXCEEDED"] }, "description": { "type": "string", "enum": [ "The transaction exceeds the receiver's receiving limit." ] } } }, { "title": "TRANSACTION_REFUSED", "properties": { "issue": { "type": "string", "enum": ["TRANSACTION_REFUSED"] }, "description": { "type": "string", "enum": ["The request was refused."] } } }, { "title": "REDIRECT_PAYER_FOR_ALTERNATE_FUNDING", "properties": { "issue": { "type": "string", "enum": ["REDIRECT_PAYER_FOR_ALTERNATE_FUNDING"] }, "description": { "type": "string", "enum": [ "Transaction failed. Redirect the payer to select another funding source." ] } } }, { "title": "ORDER_ALREADY_CAPTURED", "properties": { "issue": { "type": "string", "enum": ["ORDER_ALREADY_CAPTURED"] }, "description": { "type": "string", "enum": [ "Order already captured.If 'intent=CAPTURE' only one capture per order is allowed." ] } } }, { "title": "TRANSACTION_BLOCKED_BY_PAYEE", "properties": { "issue": { "type": "string", "enum": ["TRANSACTION_BLOCKED_BY_PAYEE"] }, "description": { "type": "string", "enum": [ "Transaction blocked by Payee’s Fraud Protection settings." ] } } }, { "title": "AUTH_CAPTURE_NOT_ENABLED", "properties": { "issue": { "type": "string", "enum": ["AUTH_CAPTURE_NOT_ENABLED"] }, "description": { "type": "string", "enum": [ "Authorization and Capture feature is not enabled for the merchant. Make sure that the recipient of the funds is a verified business account." ] } } }, { "title": "NOT_ENABLED_FOR_BANK_PROCESSING", "properties": { "issue": { "type": "string", "enum": ["NOT_ENABLED_FOR_BANK_PROCESSING"] }, "description": { "type": "string", "enum": [ "The API Caller account is not setup to be able to process bank payments. Please contact your PayPal account manager." ] } } }, { "title": "NOT_ENABLED_FOR_CARD_PROCESSING", "properties": { "issue": { "type": "string", "enum": ["NOT_ENABLED_FOR_CARD_PROCESSING"] }, "description": { "type": "string", "enum": [ "The API Caller account is not setup to be able to process card payments. Please contact PayPal customer support." ] } } }, { "title": "PAYEE_NOT_ENABLED_FOR_BANK_PROCESSING", "properties": { "issue": { "type": "string", "enum": ["PAYEE_NOT_ENABLED_FOR_BANK_PROCESSING"] }, "description": { "type": "string", "enum": [ "Payee account is not setup to be able to process bank payments. Please contact your PayPal account manager." ] } } }, { "title": "PAYEE_NOT_ENABLED_FOR_CARD_PROCESSING", "properties": { "issue": { "type": "string", "enum": ["PAYEE_NOT_ENABLED_FOR_CARD_PROCESSING"] }, "description": { "type": "string", "enum": [ "Payee account is not setup to be able to process card payments. Please contact PayPal customer support." ] } } }, { "title": "INVALID_PICKUP_ADDRESS", "properties": { "issue": { "type": "string", "enum": ["INVALID_PICKUP_ADDRESS"] }, "description": { "type": "string", "enum": [ "If the 'shipping_option.type' is set as 'PICKUP' then the 'shipping_detail.name.full_name' should start with 'S2S' meaning Ship To Store. Example: 'S2S My Store'." ] } } }, { "title": "SHIPPING_ADDRESS_INVALID", "properties": { "issue": { "type": "string", "enum": ["SHIPPING_ADDRESS_INVALID"] }, "description": { "type": "string", "enum": ["Provided shipping address is invalid."] } } }, { "title": "PAYMENT_SOURCE_NOT_SUPPORTED", "properties": { "issue": { "type": "string", "enum": ["PAYMENT_SOURCE_NOT_SUPPORTED"] }, "description": { "type": "string", "enum": [ "The payer selected method of payment is not supported when multiple purchase units are specified for an Order." ] } } }, { "title": "INELIGIBLE_SHIPPING_OPTION", "properties": { "issue": { "type": "string", "enum": ["INELIGIBLE_SHIPPING_OPTION"] }, "description": { "type": "string", "enum": [ "One or more shipping options cannot be used in conjunction with this Order." ] } } }, { "title": "ORDER_COMPLETION_IN_PROGRESS", "properties": { "issue": { "type": "string", "enum": ["ORDER_COMPLETION_IN_PROGRESS"] }, "description": { "type": "string", "enum": [ "The order was created with processing_instruction of ORDER_COMPLETE_ON_PAYMENT_APPROVAL. The customer has approved the payment and PayPal is still in the process of capturing the order on your behalf as instructed. Please try your request again." ] } } }, { "title": "BILLING_AGREEMENT_ID_MISMATCH", "properties": { "issue": { "type": "string", "enum": ["BILLING_AGREEMENT_ID_MISMATCH"] }, "description": { "type": "string", "enum": [ "Billing Agreement ID must exactly match the Billing Agreement ID that was provided during order creation." ] } } }, { "title": "PREFERRED_PAYMENT_SOURCE_MISMATCH", "properties": { "issue": { "type": "string", "enum": ["PREFERRED_PAYMENT_SOURCE_MISMATCH"] }, "description": { "type": "string", "enum": [ "Payment Source must exactly match the Preferred Payment Source that was provided during order creation." ] } } }, { "title": "INCOMPATIBLE_PARAMETER_VALUE", "properties": { "issue": { "type": "string", "enum": ["INCOMPATIBLE_PARAMETER_VALUE"] }, "description": { "type": "string", "enum": [ "The value of the field is incompatible/redundant with other fields in the order." ] } } }, { "title": "INVALID_PREVIOUS_TRANSACTION_REFERENCE", "properties": { "issue": { "type": "string", "enum": ["INVALID_PREVIOUS_TRANSACTION_REFERENCE"] }, "description": { "type": "string", "enum": [ "The authorization or capture referenced by `previous_transaction_reference` is not valid. This could be either because the previous_transaction_reference is not found or doesn't belong to the payee. Please use a valid `previous_transaction_reference`." ] } } }, { "title": "PREVIOUS_TRANSACTION_REFERENCE_HAS_CHARGEBACK", "properties": { "issue": { "type": "string", "enum": ["PREVIOUS_TRANSACTION_REFERENCE_HAS_CHARGEBACK"] }, "description": { "type": "string", "enum": [ "The capture referenced by `previous_transaction_reference` has a chargeback and hence cannot be used for this order. Please use a `previous_transaction_reference` which does not have a chargeback." ] } } }, { "title": "PREVIOUS_TRANSACTION_REFERENCE_VOIDED", "properties": { "issue": { "type": "string", "enum": ["PREVIOUS_TRANSACTION_REFERENCE_VOIDED"] }, "description": { "type": "string", "enum": [ "The status of authorization referenced by `previous_transaction_reference` is `VOIDED` and hence cannot be used for this order. Please use a `previous_transaction_reference` whose status is not `VOIDED`." ] } } }, { "title": "PAYMENT_SOURCE_MISMATCH", "properties": { "issue": { "type": "string", "enum": ["PAYMENT_SOURCE_MISMATCH"] }, "description": { "type": "string", "enum": [ "The `payment_source` in the request must match the `payment_source` used for the authorization or capture referenced by `previous_transaction_reference`. Please use `previous_transaction_reference` whose `payment_source` matches with the `payment_source` specified in the order." ] } } }, { "title": "MERCHANT_INITIATED_WITH_SECURITY_CODE", "properties": { "issue": { "type": "string", "enum": ["MERCHANT_INITIATED_WITH_SECURITY_CODE"] }, "description": { "type": "string", "enum": [ "`stored_payment_source.payment_initiator` = `MERCHANT` is not supported if `payment_source.card.security_code` is present in the order. `security_code` can be present in the order only when customer is the payment initiator. It is semantically incorrect to perform a merchant initiated payment with `security_code` is the order." ] } } }, { "title": "MERCHANT_INITIATED_WITH_AUTHENTICATION_RESULTS", "properties": { "issue": { "type": "string", "enum": ["MERCHANT_INITIATED_WITH_AUTHENTICATION_RESULTS"] }, "description": { "type": "string", "enum": [ "`stored_payment_source.payment_initiator` = `MERCHANT` is not supported if 3D-Secure authentication results are present in the order. 3D-Secure authentication results can be present in the order only when customer is the payment initiator. It is semantically incorrect to perform a merchant initiated payment with 3D-Secure authentication results is the order." ] } } }, { "title": "MERCHANT_INITIATED_WITH_MULTIPLE_PURCHASE_UNITS", "properties": { "issue": { "type": "string", "enum": [ "MERCHANT_INITIATED_WITH_MULTIPLE_PURCHASE_UNITS" ] }, "description": { "type": "string", "enum": [ "`stored_payment_source.payment_initiator` = `MERCHANT` is not supported if more than one purchase_unit is present in the Order. Merchant initiated payments are not supported from orders with more than one purchase_unit. Please retry the request with multiple Order requests (one for each purchase_unit)." ] } } }, { "title": "RETURN_URL_REQUIRED", "properties": { "issue": { "type": "string", "enum": ["RETURN_URL_REQUIRED"] }, "description": { "type": "string", "enum": [ "The return url is required when attempting to vault this source." ] } } }, { "title": "CANCEL_URL_REQUIRED", "properties": { "issue": { "type": "string", "enum": ["CANCEL_URL_REQUIRED"] }, "description": { "type": "string", "enum": [ "The cancel url is required when attempting to vault this source." ] } } }, { "title": "SETUP_ERROR_FOR_BANK", "properties": { "issue": { "type": "string", "enum": ["SETUP_ERROR_FOR_BANK"] }, "description": { "type": "string", "enum": [ "The API Caller account setup, for bank payments, is incomplete or incorrect. Please contact your PayPal account manager." ] } } }, { "title": "BANK_NOT_SUPPORTED_FOR_VERIFICATION", "properties": { "issue": { "type": "string", "enum": ["BANK_NOT_SUPPORTED_FOR_VERIFICATION"] }, "description": { "type": "string", "enum": [ "Verification for this bank account is not supported." ] } } }, { "title": "PAYER_ACTION_REQUIRED", "properties": { "issue": { "type": "string", "enum": ["PAYER_ACTION_REQUIRED"] }, "description": { "type": "string", "enum": [ "Transaction cannot complete successfully, instruct the buyer to return to PayPal." ] } } }, { "title": "APPLE_PAY_AMOUNT_MISMATCH", "properties": { "issue": { "type": "string", "enum": ["APPLE_PAY_AMOUNT_MISMATCH"] }, "description": { "type": "string", "enum": [ "The 'amount' specified in the Order should match the amount that was viewed and authorized by the payer/buyer on Apple Pay. If the amount has changed, please redirect the buyer to authorize the order again via Apple Pay." ] } } }, { "title": "CURRENCY_NOT_SUPPORTED_FOR_BANK", "properties": { "issue": { "type": "string", "enum": ["CURRENCY_NOT_SUPPORTED_FOR_BANK"] }, "description": { "type": "string", "enum": [ "The payment_source does not support the currency of the Order. For ACH debit, only USD is supported and for SEPA debit, only EUR is supported." ] } } }, { "title": "ONLY_ONE_BANK_SOURCE_ALLOWED", "properties": { "issue": { "type": "string", "enum": ["ONLY_ONE_BANK_SOURCE_ALLOWED"] }, "description": { "type": "string", "enum": [ "More than one payment method within the bank payment object is not supported." ] } } }, { "title": "INVALID_IBAN", "properties": { "issue": { "type": "string", "enum": ["INVALID_IBAN"] }, "description": { "type": "string", "enum": [ "IBAN provided is not a valid bank account number." ] } } }, { "title": "IBAN_COUNTRY_NOT_SUPPORTED", "properties": { "issue": { "type": "string", "enum": ["IBAN_COUNTRY_NOT_SUPPORTED"] }, "description": { "type": "string", "enum": [ "Country code of issuer bank for the provided IBAN is not supported for SEPA debit payments." ] } } }, { "title": "CARD_NUMBER_REQUIRED", "properties": { "issue": { "type": "string", "enum": ["CARD_NUMBER_REQUIRED"] }, "description": { "type": "string", "enum": [ "The card number is required when attempting to process payment with card." ] } } }, { "title": "CARD_EXPIRY_REQUIRED", "properties": { "issue": { "type": "string", "enum": ["CARD_EXPIRY_REQUIRED"] }, "description": { "type": "string", "enum": [ "The card expiry is required when attempting to process payment with card." ] } } }, { "title": "VAULT_INSTRUCTION_REQUIRED", "properties": { "issue": { "type": "string", "enum": ["VAULT_INSTRUCTION_REQUIRED"] }, "description": { "type": "string", "enum": [ "Vault instruction is required. Please use `vault.store_in_vault` to provide vault instruction." ] } } }, { "title": "MISMATCHED_VAULT_ID_TO_PAYMENT_SOURCE", "properties": { "issue": { "type": "string", "enum": ["MISMATCHED_VAULT_ID_TO_PAYMENT_SOURCE"] }, "description": { "type": "string", "enum": [ "The vault_id does not match the payment_source provided. Please verify that the vault_id token used refers to the matching payment_source and try again. For example, a PayPal token cannot be passed in the vault_id field in the payment_source.card object." ] } } }, { "title": "MISMATCHED_VAULT_OWNER_ID", "properties": { "issue": { "type": "string", "enum": ["MISMATCHED_VAULT_OWNER_ID"] }, "description": { "type": "string", "enum": [ "The owner_id does not match with the API caller. Please verify that the owner_id is same as the API caller's payer id." ] } } }, { "title": "VAULT_OWNER_ID_NOT_SUPPORTED", "properties": { "issue": { "type": "string", "enum": ["VAULT_OWNER_ID_NOT_SUPPORTED"] }, "description": { "type": "string", "enum": [ "API caller is not enabled to specify the vault owner_id explicitly. Please contact account manager to enable the functionality." ] } } }, { "title": "NOT_ELIGIBLE_FOR_PNREF_PROCESSING", "properties": { "issue": { "type": "string", "enum": ["NOT_ELIGIBLE_FOR_PNREF_PROCESSING"] }, "description": { "type": "string", "enum": [ "API caller is not enabled to process payments with the `pnref`. Please contact customer support to request permissions to process transactions with PNREF." ] } } }, { "title": "NOT_ELIGIBLE_FOR_PAYPAL_TRANSACTION_ID_PROCESSING", "properties": { "issue": { "type": "string", "enum": [ "NOT_ELIGIBLE_FOR_PAYPAL_TRANSACTION_ID_PROCESSING" ] }, "description": { "type": "string", "enum": [ "API caller is not enable to process payments using `paypal_transaction_id`. Please contact customer support to request permissions to process transactions with PayPal transaction ID." ] } } }, { "title": "PAYPAL_TRANSACTION_ID_NOT_FOUND", "properties": { "issue": { "type": "string", "enum": ["PAYPAL_TRANSACTION_ID_NOT_FOUND"] }, "description": { "type": "string", "enum": [ "Specified `paypal_transaction_id` was not found. Verify the value and try the request again." ] } } }, { "title": "PNREF_NOT_FOUND", "properties": { "issue": { "type": "string", "enum": ["PNREF_NOT_FOUND"] }, "description": { "type": "string", "enum": [ "Specified `pnref` was not found. Verify the value and try the request again." ] } } }, { "title": "INVALID_VAULT_SETUP_TOKEN", "properties": { "issue": { "type": "string", "enum": ["INVALID_VAULT_SETUP_TOKEN"] }, "description": { "type": "string", "enum": [ "The specified Vault Setup Token is invalid or could not be found." ] } } }, { "title": "INVALID_SECURITY_CODE_LENGTH", "properties": { "issue": { "type": "string", "enum": ["INVALID_SECURITY_CODE_LENGTH"] }, "description": { "type": "string", "enum": [ "The security_code length is invalid for the specified card brand." ] } } }, { "title": "PLATFORM_FEE_PAYEE_CANNOT_BE_SAME_AS_PAYER", "properties": { "issue": { "type": "string", "enum": ["PLATFORM_FEE_PAYEE_CANNOT_BE_SAME_AS_PAYER"] }, "description": { "type": "string", "enum": [ "The payer cannot pay themselves. The recipient account of the platform fees must be different from the payer account." ] } } }, { "title": "REQUIRED_PARAMETER_FOR_CUSTOMER_INITIATED_PAYMENT", "properties": { "issue": { "type": "string", "enum": [ "REQUIRED_PARAMETER_FOR_CUSTOMER_INITIATED_PAYMENT" ] }, "description": { "type": "string", "enum": [ "This parameter is required when the customer is present. If the customer is not present, indicate so by sending payment_initiator=`MERCHANT`. For details, see Stored Credential." ] } } }, { "title": "IDENTIFIER_NOT_FOUND", "properties": { "issue": { "type": "string", "enum": ["IDENTIFIER_NOT_FOUND"] }, "description": { "type": "string", "enum": [ "Specified identifier was not found. Please verify the correct identifier was used and try the request again." ] } } }, { "title": "INCOMPATIBLE_ACCOUNT_OWNERSHIP_TYPE", "properties": { "issue": { "type": "string", "enum": ["INCOMPATIBLE_ACCOUNT_OWNERSHIP_TYPE"] }, "description": { "type": "string", "enum": [ "Account ownership type is not compatible with standard entry class code." ] } } }, { "title": "COUNTRY_NOT_SUPPORTED_BY_PAYMENT_SOURCE", "properties": { "issue": { "type": "string", "enum": ["COUNTRY_NOT_SUPPORTED_BY_PAYMENT_SOURCE"] }, "description": { "type": "string", "enum": [ "Country code provided is not supported by the provided payment source." ] } } }, { "title": "LOCALE_NOT_SUPPORTED_BY_PAYMENT_SOURCE", "properties": { "issue": { "type": "string", "enum": ["LOCALE_NOT_SUPPORTED_BY_PAYMENT_SOURCE"] }, "description": { "type": "string", "enum": [ "Locale provided is not supported by the provided payment source." ] } } }, { "title": "BANK_VERIFICATION_REQUIRED", "properties": { "issue": { "type": "string", "enum": ["BANK_VERIFICATION_REQUIRED"] }, "description": { "type": "string", "enum": ["Only verified bank accounts can be processed."] } } }, { "title": "INVALID_VAULT_ID", "properties": { "issue": { "type": "string", "enum": ["INVALID_VAULT_ID"] }, "description": { "type": "string", "enum": [ "The specified Vault ID is invalid or could not be found." ] } } }, { "title": "NOT_ENABLED_FOR_PAYMENT_SOURCE", "properties": { "issue": { "type": "string", "enum": ["NOT_ENABLED_FOR_PAYMENT_SOURCE"] }, "description": { "type": "string", "enum": [ "The 'API caller' and/or 'payee' is not setup to be able to process the selected payment source. If you have already completed the required steps, please allow 2 business days for PayPal to complete the setup. If you continue to receive this error, please contact your Account Manager or check status at https://www.paypal.com/businessmanage/account/payments." ] } } }, { "title": "AUTO_CAPTURE_ENABLED", "properties": { "issue": { "type": "string", "enum": ["AUTO_CAPTURE_ENABLED"] }, "description": { "type": "string", "enum": [ "This order is being auto-captured. Merchant initiated capture requests are not allowed." ] } } } ] } } } }, "orders.confirm-400": { "properties": { "details": { "type": "array", "items": { "anyOf": [ { "title": "INVALID_PARAMETER_SYNTAX", "properties": { "issue": { "type": "string", "enum": ["INVALID_PARAMETER_SYNTAX"] }, "description": { "type": "string", "enum": [ "The value of the field does not conform to the expected format." ] } } }, { "title": "INVALID_PARAMETER_VALUE", "properties": { "issue": { "type": "string", "enum": ["INVALID_PARAMETER_VALUE"] }, "description": { "type": "string", "enum": ["A parameter value is not valid."] } } }, { "title": "MISSING_REQUIRED_PARAMETER", "properties": { "issue": { "type": "string", "enum": ["MISSING_REQUIRED_PARAMETER"] }, "description": { "type": "string", "enum": ["A required field / parameter is missing"] } } }, { "title": "INVALID_STRING_LENGTH", "properties": { "issue": { "type": "string", "enum": ["INVALID_STRING_LENGTH"] }, "description": { "type": "string", "enum": [ "The value of a field is either too short or too long" ] } } }, { "title": "INVALID_STRING_MAX_LENGTH", "properties": { "issue": { "type": "string", "enum": ["INVALID_STRING_MAX_LENGTH"] }, "description": { "type": "string", "enum": ["The value of a field is too long."] } } }, { "title": "MALFORMED_REQUEST_JSON", "properties": { "issue": { "type": "string", "enum": ["MALFORMED_REQUEST_JSON"] }, "description": { "type": "string", "enum": ["The request JSON is not well formed."] } } } ] } } } }, "orders.confirm-422": { "properties": { "details": { "type": "array", "items": { "anyOf": [ { "title": "ORDER_ALREADY_CAPTURED", "properties": { "issue": { "type": "string", "enum": ["ORDER_ALREADY_CAPTURED"] }, "description": { "type": "string", "enum": [ "Order already captured. If 'intent=CAPTURE' only one capture per order is allowed." ] } } }, { "title": "ORDER_ALREADY_AUTHORIZED", "properties": { "issue": { "type": "string", "enum": ["ORDER_ALREADY_AUTHORIZED"] }, "description": { "type": "string", "enum": [ "Order already captured. If 'intent=CAPTURE' only one capture per order is allowed." ] } } }, { "title": "ORDER_CANNOT_BE_CONFIRMED", "properties": { "issue": { "type": "string", "enum": ["ORDER_CANNOT_BE_CONFIRMED"] }, "description": { "type": "string", "enum": [ "An order with status = 'COMPLETED' cannot be confirmed again." ] } } }, { "title": "MISSING_PREVIOUS_REFERENCE", "properties": { "issue": { "type": "string", "enum": ["MISSING_PREVIOUS_REFERENCE"] }, "description": { "type": "string", "enum": [ "For Merchant initiated network token transactions, either the payment_source.card.stored_credential.previous_network_transaction_reference or payment_source.card.stored_credential.previous_transaction_reference must be included in the request." ] } } }, { "title": "MISSING_CRYPTOGRAM", "properties": { "issue": { "type": "string", "enum": ["MISSING_CRYPTOGRAM"] }, "description": { "type": "string", "enum": [ "Cryptogram is mandatory for any customer initiated network token transactions." ] } } }, { "title": "CURRENCY_NOT_SUPPORTED_FOR_COUNTRY", "properties": { "issue": { "type": "string", "enum": ["CURRENCY_NOT_SUPPORTED_FOR_COUNTRY"] }, "description": { "type": "string", "enum": [ " For the payment_source specified, the currency of the Order is restricted by the country in which the payee account is based. Please refer https://developer.paypal.com/api/rest/reference/currency-codes/ for list of supported currency codes." ] } } }, { "title": "CARD_EXPIRED", "properties": { "issue": { "type": "string", "enum": ["CARD_EXPIRED"] }, "description": { "type": "string", "enum": ["The card is expired"] } } }, { "title": "CARD_TYPE_NOT_SUPPORTED", "properties": { "issue": { "type": "string", "enum": ["CARD_TYPE_NOT_SUPPORTED"] }, "description": { "type": "string", "enum": [ "Processing of this card type is not supported. Use another card type." ] } } }, { "title": "CURRENCY_NOT_SUPPORTED_FOR_CARD_TYPE", "properties": { "issue": { "type": "string", "enum": ["CURRENCY_NOT_SUPPORTED_FOR_CARD_TYPE"] }, "description": { "type": "string", "enum": [ "The issued currency code of this card is not supported for direct card payments. Please refer https://developer.paypal.com/api/rest/reference/currency-codes/ for list of supported currency codes." ] } } }, { "title": "CARD_COUNTRY_NOT_SUPPORTED", "properties": { "issue": { "type": "string", "enum": ["CARD_COUNTRY_NOT_SUPPORTED"] }, "description": { "type": "string", "enum": [ "The country in which this card was issued is not currently supported. Please use another card to continue with this transaction." ] } } }, { "title": "CARD_DATA_NOT_FOUND", "properties": { "issue": { "type": "string", "enum": ["CARD_DATA_NOT_FOUND"] }, "description": { "type": "string", "enum": [ "The card issuer data information could not be retrieved. Please use a different card to proceed with this transaction." ] } } }, { "title": "ONLY_ONE_PAYMENT_SOURCE_ALLOWED", "properties": { "issue": { "type": "string", "enum": ["ONLY_ONE_PAYMENT_SOURCE_ALLOWED"] }, "description": { "type": "string", "enum": [ "More than one payment method within the payment source is not supported." ] } } }, { "title": "NO_PAYMENT_SOURCE_PROVIDED", "properties": { "issue": { "type": "string", "enum": ["NO_PAYMENT_SOURCE_PROVIDED"] }, "description": { "type": "string", "enum": [ "At least one payment method is required within the payment source." ] } } }, { "title": "PAYMENT_ALREADY_APPROVED", "properties": { "issue": { "type": "string", "enum": ["PAYMENT_ALREADY_APPROVED"] }, "description": { "type": "string", "enum": [ "The payment has already been approved. Please capture the order, or create and confirm a new order with this payment source." ] } } }, { "title": "PAYMENT_ORIGIN_NOT_ENABLED", "properties": { "issue": { "type": "string", "enum": ["PAYMENT_ORIGIN_NOT_ENABLED"] }, "description": { "type": "string", "enum": [ "The API caller account or payee is not enabled for the given 'payment_origin' option. Please contact customer support for assistance." ] } } }, { "title": "UNSUPPORTED_PROCESSING_INSTRUCTION", "properties": { "issue": { "type": "string", "enum": ["UNSUPPORTED_PROCESSING_INSTRUCTION"] }, "description": { "type": "string", "enum": [ "The specified processing_instruction is not supported for the given payment_source. Please refer to https://developer.paypal.com/api/orders/v2/#definition-processing_instruction for the list of payment_source that can be specified with this value." ] } } }, { "title": "INELIGIBLE_SHIPPING_OPTION", "properties": { "issue": { "type": "string", "enum": ["INELIGIBLE_SHIPPING_OPTION"] }, "description": { "type": "string", "enum": [ "One or more shipping options cannot be used in conjunction with this Order." ] } } }, { "title": "ORDER_COMPLETE_ON_PAYMENT_APPROVAL", "properties": { "issue": { "type": "string", "enum": ["ORDER_COMPLETE_ON_PAYMENT_APPROVAL"] }, "description": { "type": "string", "enum": [ "A processing_instruction of `ORDER_COMPLETE_ON_PAYMENT_APPROVAL` is required for the specified payment_source." ] } } }, { "title": "INVALID_EXPIRY_DATE", "properties": { "issue": { "type": "string", "enum": ["INVALID_EXPIRY_DATE"] }, "description": { "type": "string", "enum": [ "Expiry date is invalid. Expiry date should be a date in future and within the threshold for the payment source." ] } } }, { "title": "TOKEN_EXPIRED", "properties": { "issue": { "type": "string", "enum": ["TOKEN_EXPIRED"] }, "description": { "type": "string", "enum": [ "The token is expired and cannot be used for payment." ] } } }, { "title": "INVALID_GOOGLE_PAY_TOKEN", "properties": { "issue": { "type": "string", "enum": ["INVALID_GOOGLE_PAY_TOKEN"] }, "description": { "type": "string", "enum": [ "The google pay token is invalid. PayPal was not able to decrypt the googlepay token or PayPal was not able to find the necessary data in the token after decryption." ] } } }, { "title": "GOOGLE_PAY_GATEWAY_MERCHANT_ID_MISMATCH", "properties": { "issue": { "type": "string", "enum": ["GOOGLE_PAY_GATEWAY_MERCHANT_ID_MISMATCH"] }, "description": { "type": "string", "enum": [ "The gateway merchant ID in Google Pay token is not valid. This could be because the gateway merchant Id that was authorized by payer/buyer on Google Pay does not match with the API caller of the order." ] } } }, { "title": "CRYPTOGRAM_REQUIRED", "properties": { "issue": { "type": "string", "enum": ["CRYPTOGRAM_REQUIRED"] }, "description": { "type": "string", "enum": [ "Cryptogram is required if authentication method is CRYPTOGRAM 3DS." ] } } }, { "title": "ONE_OF_PARAMETERS_REQUIRED", "properties": { "issue": { "type": "string", "enum": ["ONE_OF_PARAMETERS_REQUIRED"] }, "description": { "type": "string", "enum": [ "One or more field is required to continue with this request." ] } } }, { "title": "RETURN_URL_REQUIRED", "properties": { "issue": { "type": "string", "enum": ["RETURN_URL_REQUIRED"] }, "description": { "type": "string", "enum": [ "The return url is required when attempting to vault this source." ] } } }, { "title": "CANCEL_URL_REQUIRED", "properties": { "issue": { "type": "string", "enum": ["CANCEL_URL_REQUIRED"] }, "description": { "type": "string", "enum": [ "The cancel url is required when attempting to vault this source." ] } } }, { "title": "COUNTRY_NOT_SUPPORTED_BY_PAYMENT_SOURCE", "properties": { "issue": { "type": "string", "enum": ["COUNTRY_NOT_SUPPORTED_BY_PAYMENT_SOURCE"] }, "description": { "type": "string", "enum": [ "Country code provided is not supported by the provided payment source." ] } } }, { "title": "REQUIRED_PARAMETER_FOR_PAYMENT_SOURCE", "properties": { "issue": { "type": "string", "enum": ["REQUIRED_PARAMETER_FOR_PAYMENT_SOURCE"] }, "description": { "type": "string", "enum": [ "The parameter is required for provided payment source." ] } } }, { "title": "REQUIRED_PARAMETER_FOR_CUSTOMER_INITIATED_PAYMENT", "properties": { "issue": { "type": "string", "enum": [ "REQUIRED_PARAMETER_FOR_CUSTOMER_INITIATED_PAYMENT" ] }, "description": { "type": "string", "enum": [ "This parameter is required when the customer is present. If the customer is not present, indicate so by sending payment_initiator=`MERCHANT`. For details, see Stored Credential." ] } } }, { "title": "ITEM_CATEGORY_NOT_SUPPORTED_BY_PAYMENT_SOURCE", "properties": { "issue": { "type": "string", "enum": ["ITEM_CATEGORY_NOT_SUPPORTED_BY_PAYMENT_SOURCE"] }, "description": { "type": "string", "enum": [ "The provided payment source does not support provided item category." ] } } }, { "title": "PAYMENT_SOURCE_INFO_CANNOT_BE_VERIFIED", "properties": { "issue": { "type": "string", "enum": ["PAYMENT_SOURCE_INFO_CANNOT_BE_VERIFIED"] }, "description": { "type": "string", "enum": [ "The combination of the payment_source name, billing address, shipping name and shipping address could not be verified. Please correct this information and try again by creating a new order." ] } } }, { "title": "PAYMENT_SOURCE_DECLINED_BY_PROCESSOR", "properties": { "issue": { "type": "string", "enum": ["PAYMENT_SOURCE_DECLINED_BY_PROCESSOR"] }, "description": { "type": "string", "enum": [ "The provided payment source is declined by the processor. Please try again with a different payment source by creating a new order." ] } } }, { "title": "PAYMENT_SOURCE_CANNOT_BE_USED", "properties": { "issue": { "type": "string", "enum": ["PAYMENT_SOURCE_CANNOT_BE_USED"] }, "description": { "type": "string", "enum": [ "The provided payment source cannot be used to pay for the order. Please try again with a different payment source by creating a new order." ] } } }, { "title": "SETUP_ERROR_FOR_BANK", "properties": { "issue": { "type": "string", "enum": ["SETUP_ERROR_FOR_BANK"] }, "description": { "type": "string", "enum": [ "The API Caller account setup, for bank payments, is incomplete or incorrect. Please contact your PayPal account manager." ] } } }, { "title": "BANK_NOT_SUPPORTED_FOR_VERIFICATION", "properties": { "issue": { "type": "string", "enum": ["BANK_NOT_SUPPORTED_FOR_VERIFICATION"] }, "description": { "type": "string", "enum": [ "Verification for this bank account is not supported." ] } } }, { "title": "APPLE_PAY_AMOUNT_MISMATCH", "properties": { "issue": { "type": "string", "enum": ["APPLE_PAY_AMOUNT_MISMATCH"] }, "description": { "type": "string", "enum": [ "The 'amount' specified in the Order should match the amount that was viewed and authorized by the payer/buyer on Apple Pay. If the amount has changed, please redirect the buyer to authorize the order again via Apple Pay." ] } } }, { "title": "ONE_OF_THE_PARAMETERS_REQUIRED", "properties": { "issue": { "type": "string", "enum": ["ONE_OF_THE_PARAMETERS_REQUIRED"] }, "description": { "type": "string", "enum": [ "One or more field is required to continue with this request." ] } } }, { "title": "BILLING_ADDRESS_INVALID", "properties": { "issue": { "type": "string", "enum": ["BILLING_ADDRESS_INVALID"] }, "description": { "type": "string", "enum": ["Provided billing address is invalid."] } } }, { "title": "SHIPPING_ADDRESS_INVALID", "properties": { "issue": { "type": "string", "enum": ["SHIPPING_ADDRESS_INVALID"] }, "description": { "type": "string", "enum": ["Provided shipping address is invalid."] } } }, { "title": "ORDER_IS_PENDING_APPROVAL", "properties": { "issue": { "type": "string", "enum": ["ORDER_IS_PENDING_APPROVAL"] }, "description": { "type": "string", "enum": [ "The order was confirmed and payer action completed but order approval processing from PayPal is pending. No action is needed from Payee or Payer. Please wait until order status changes to 'APPROVED'." ] } } }, { "title": "DEVICE_DATA_NOT_AVAILABLE", "properties": { "issue": { "type": "string", "enum": ["DEVICE_DATA_NOT_AVAILABLE"] }, "description": { "type": "string", "enum": [ "Device Data is not available for processing this order. The PayPal-Client-Metadata-Id header value sent during `Create Order` api call is either missing or incorrect or there was an error in collecting required data. Please verify if appropriate value for PayPal-Client-Metadata-Id header is being sent during 'Create Order' api call. Please note this error only applies to payment_source.pay_upon_invoice at the moment." ] } } }, { "title": "COMPLIANCE_VIOLATION", "properties": { "issue": { "type": "string", "enum": ["COMPLIANCE_VIOLATION"] }, "description": { "type": "string", "enum": [ "Transaction is declined due to compliance violation." ] } } }, { "title": "CURRENCY_NOT_SUPPORTED_FOR_BANK", "properties": { "issue": { "type": "string", "enum": ["CURRENCY_NOT_SUPPORTED_FOR_BANK"] }, "description": { "type": "string", "enum": [ "The payment_source does not support the currency of the Order. For ACH debit, only USD is supported and for SEPA debit, only EUR is supported." ] } } }, { "title": "ONLY_ONE_BANK_SOURCE_ALLOWED", "properties": { "issue": { "type": "string", "enum": ["ONLY_ONE_BANK_SOURCE_ALLOWED"] }, "description": { "type": "string", "enum": [ "More than one payment method within the bank payment object is not supported." ] } } }, { "title": "INVALID_IBAN", "properties": { "issue": { "type": "string", "enum": ["INVALID_IBAN"] }, "description": { "type": "string", "enum": [ "IBAN provided is not a valid bank account number." ] } } }, { "title": "IBAN_COUNTRY_NOT_SUPPORTED", "properties": { "issue": { "type": "string", "enum": ["IBAN_COUNTRY_NOT_SUPPORTED"] }, "description": { "type": "string", "enum": [ "Country code of issuer bank for the provided IBAN is not supported for SEPA debit payments." ] } } }, { "title": "PAYEE_COUNTRY_NOT_SUPPORTED_FOR_PAYMENT_SOURCE", "properties": { "issue": { "type": "string", "enum": ["PAYEE_COUNTRY_NOT_SUPPORTED_FOR_PAYMENT_SOURCE"] }, "description": { "type": "string", "enum": [ "Payee country code is not supported by the provided payment source." ] } } }, { "title": "CARD_NUMBER_REQUIRED", "properties": { "issue": { "type": "string", "enum": ["CARD_NUMBER_REQUIRED"] }, "description": { "type": "string", "enum": [ "The card number is required when attempting to process payment with card." ] } } }, { "title": "CARD_EXPIRY_REQUIRED", "properties": { "issue": { "type": "string", "enum": ["CARD_EXPIRY_REQUIRED"] }, "description": { "type": "string", "enum": [ "The card expiry is required when attempting to process payment with card." ] } } }, { "title": "INCOMPATIBLE_PARAMETER_VALUE", "properties": { "issue": { "type": "string", "enum": ["INCOMPATIBLE_PARAMETER_VALUE"] }, "description": { "type": "string", "enum": [ "The value of the field is incompatible/redundant with other fields in the order." ] } } }, { "title": "VAULT_INSTRUCTION_DUPLICATED", "properties": { "issue": { "type": "string", "enum": ["VAULT_INSTRUCTION_DUPLICATED"] }, "description": { "type": "string", "enum": [ "Only one vault instruction is allowed. Please use `vault.store_in_vault` to provide vault instruction." ] } } }, { "title": "VAULT_INSTRUCTION_REQUIRED", "properties": { "issue": { "type": "string", "enum": ["VAULT_INSTRUCTION_REQUIRED"] }, "description": { "type": "string", "enum": [ "Vault instruction is required. Please use `vault.store_in_vault` to provide vault instruction." ] } } }, { "title": "MISMATCHED_VAULT_OWNER_ID", "properties": { "issue": { "type": "string", "enum": ["MISMATCHED_VAULT_OWNER_ID"] }, "description": { "type": "string", "enum": [ "The owner_id does not match with the API caller. Please verify that the owner_id is same as the API caller's payer id." ] } } }, { "title": "VAULT_OWNER_ID_NOT_SUPPORTED", "properties": { "issue": { "type": "string", "enum": ["VAULT_OWNER_ID_NOT_SUPPORTED"] }, "description": { "type": "string", "enum": [ "API caller is not enabled to specify the vault owner_id explicitly. Please contact account manager to enable the functionality." ] } } }, { "title": "MISMATCHED_VAULT_ID_TO_PAYMENT_SOURCE", "properties": { "issue": { "type": "string", "enum": ["MISMATCHED_VAULT_ID_TO_PAYMENT_SOURCE"] }, "description": { "type": "string", "enum": [ "The vault_id does not match the payment_source provided. Please verify that the vault_id token used refers to the matching payment_source and try again. For example, a PayPal token cannot be passed in the vault_id field in the payment_source.card object." ] } } }, { "title": "NOT_ELIGIBLE_FOR_PNREF_PROCESSING", "properties": { "issue": { "type": "string", "enum": ["NOT_ELIGIBLE_FOR_PNREF_PROCESSING"] }, "description": { "type": "string", "enum": [ "API caller is not enabled to process payments with the `pnref`. Please contact customer support to request permissions to process transactions with PNREF." ] } } }, { "title": "NOT_ELIGIBLE_FOR_PAYPAL_TRANSACTION_ID_PROCESSING", "properties": { "issue": { "type": "string", "enum": [ "NOT_ELIGIBLE_FOR_PAYPAL_TRANSACTION_ID_PROCESSING" ] }, "description": { "type": "string", "enum": [ "API caller is not enable to process payments using `paypal_transaction_id`. Please contact customer support to request permissions to process transactions with PayPal transaction ID." ] } } }, { "title": "PAYPAL_TRANSACTION_ID_NOT_FOUND", "properties": { "issue": { "type": "string", "enum": ["PAYPAL_TRANSACTION_ID_NOT_FOUND"] }, "description": { "type": "string", "enum": [ "Specified `paypal_transaction_id` was not found. Verify the value and try the request again." ] } } }, { "title": "PNREF_NOT_FOUND", "properties": { "issue": { "type": "string", "enum": ["PNREF_NOT_FOUND"] }, "description": { "type": "string", "enum": [ "Specified `pnref` was not found. Verify the value and try the request again." ] } } }, { "title": "INVALID_SECURITY_CODE_LENGTH", "properties": { "issue": { "type": "string", "enum": ["INVALID_SECURITY_CODE_LENGTH"] }, "description": { "type": "string", "enum": [ "The security_code length is invalid for the specified card brand." ] } } }, { "title": "NOT_ENABLED_TO_VAULT_PAYMENT_SOURCE", "properties": { "issue": { "type": "string", "enum": ["NOT_ENABLED_TO_VAULT_PAYMENT_SOURCE"] }, "description": { "type": "string", "enum": [ "The API caller or the merchant on whose behalf the API call is initiated is not allowed to vault the given source. Please contact PayPal customer support for assistance." ] } } }, { "title": "CRYPTOGRAM_REQUIRED", "properties": { "issue": { "type": "string", "enum": ["CRYPTOGRAM_REQUIRED"] }, "description": { "type": "string", "enum": [ "Cryptogram is required if authentication method is CRYPTOGRAM 3DS." ] } } }, { "title": "EMV_DATA_REQUIRED", "properties": { "issue": { "type": "string", "enum": ["EMV_DATA_REQUIRED"] }, "description": { "type": "string", "enum": [ "EMV Data is required if authentication method is EMV." ] } } }, { "title": "ALIAS_DECLINED_BY_PROCESSOR", "properties": { "issue": { "type": "string", "enum": ["ALIAS_DECLINED_BY_PROCESSOR"] }, "description": { "type": "string", "enum": [ "The provided alias was declined by the processor. Please create a new order with a different alias_key and/or alias_label and try again." ] } } }, { "title": "BLIK_ONE_CLICK_MISSING_REQUIRED_PARAMETER", "properties": { "issue": { "type": "string", "enum": ["BLIK_ONE_CLICK_MISSING_REQUIRED_PARAMETER"] }, "description": { "type": "string", "enum": [ "Blik's one_click flow requires one_click.auth_code and one_click.alias_label parameters for the buyer's first transaction. For all subsequent transactions,only the one_click.alias_key parameter is required." ] } } }, { "title": "TRANSACTION_LIMIT_EXCEEDED", "properties": { "issue": { "type": "string", "enum": ["TRANSACTION_LIMIT_EXCEEDED"] }, "description": { "type": "string", "enum": [ "Total payment amount exceeded transaction limit." ] } } }, { "title": "PUI_DUPLICATE_ORDER", "properties": { "issue": { "type": "string", "enum": ["PUI_DUPLICATE_ORDER"] }, "description": { "type": "string", "enum": [ "A Pay Upon Invoice (Rechnungskauf) order with the same payload has already been successfully processed in the last few seconds. To process a new order, please try again in a few seconds." ] } } }, { "title": "NOT_ENABLED_FOR_PAYMENT_SOURCE", "properties": { "issue": { "type": "string", "enum": ["NOT_ENABLED_FOR_PAYMENT_SOURCE"] }, "description": { "type": "string", "enum": [ "The 'API caller' and/or 'payee' is not setup to be able to process the selected payment source. If you have already completed the required steps, please allow 2 business days for PayPal to complete the setup. If you continue to receive this error, please contact your Account Manager or check status at https://www.paypal.com/businessmanage/account/payments." ] } } }, { "title": "INVALID_VAULT_ID", "properties": { "issue": { "type": "string", "enum": ["INVALID_VAULT_ID"] }, "description": { "type": "string", "enum": [ "The specified Vault ID is invalid or could not be found." ] } } }, { "title": "MULTIPLE_PURCHASE_UNITS_NOT_SUPPORTED_FOR_PAYMENT_SOURCE", "properties": { "issue": { "type": "string", "enum": [ "MULTIPLE_PURCHASE_UNITS_NOT_SUPPORTED_FOR_PAYMENT_SOURCE" ] }, "description": { "type": "string", "enum": [ "The provided payment source cannot be used to pay for the multiple purchase units order." ] } } }, { "title": "LOCALE_NOT_SUPPORTED_BY_PAYMENT_SOURCE", "properties": { "issue": { "type": "string", "enum": ["LOCALE_NOT_SUPPORTED_BY_PAYMENT_SOURCE"] }, "description": { "type": "string", "enum": [ "Locale provided is not supported by the provided payment source." ] } } }, { "title": "BANK_VERIFICATION_REQUIRED", "properties": { "issue": { "type": "string", "enum": ["BANK_VERIFICATION_REQUIRED"] }, "description": { "type": "string", "enum": ["Only verified bank accounts can be processed."] } } } ] } } } }, "orders.patch-400": { "properties": { "details": { "type": "array", "items": { "anyOf": [ { "title": "FIELD_NOT_PATCHABLE", "properties": { "issue": { "type": "string", "enum": ["FIELD_NOT_PATCHABLE"] }, "description": { "type": "string", "enum": ["Field cannot be patched."] } } }, { "title": "INVALID_ARRAY_MAX_ITEMS", "properties": { "issue": { "type": "string", "enum": ["INVALID_ARRAY_MAX_ITEMS"] }, "description": { "type": "string", "enum": [ "The number of items in an array parameter is too large." ] } } }, { "title": "INVALID_PARAMETER_SYNTAX", "properties": { "issue": { "type": "string", "enum": ["INVALID_PARAMETER_SYNTAX"] }, "description": { "type": "string", "enum": [ "The value of a field does not conform to the expected format." ] } } }, { "title": "INVALID_STRING_LENGTH", "properties": { "issue": { "type": "string", "enum": ["INVALID_STRING_LENGTH"] }, "description": { "type": "string", "enum": [ "The value of a field is either too short or too long" ] } } }, { "title": "INVALID_PARAMETER_VALUE", "properties": { "issue": { "type": "string", "enum": ["INVALID_PARAMETER_VALUE"] }, "description": { "type": "string", "enum": ["The value of a field is invalid."] } } }, { "title": "MISSING_REQUIRED_PARAMETER", "properties": { "issue": { "type": "string", "enum": ["MISSING_REQUIRED_PARAMETER"] }, "description": { "type": "string", "enum": ["A required field / parameter is missing."] } } }, { "title": "AMOUNT_NOT_PATCHABLE", "properties": { "issue": { "type": "string", "enum": ["AMOUNT_NOT_PATCHABLE"] }, "description": { "type": "string", "enum": [ "The amount cannot be updated as the 'payer' has chosen and approved a specific financing offer for a given amount. Please Create a new Order with the updated Order amount and have the 'payer' approve the new payment terms." ] } } }, { "title": "INVALID_PATCH_OPERATION", "properties": { "issue": { "type": "string", "enum": ["INVALID_PATCH_OPERATION"] }, "description": { "type": "string", "enum": [ "The operation cannot be honored. Cannot add a property that's already present, use replace. Cannot remove a property thats not present, use add. Cannot replace a property thats not present, use add." ] } } }, { "title": "MALFORMED_REQUEST_JSON", "properties": { "issue": { "type": "string", "enum": ["MALFORMED_REQUEST_JSON"] }, "description": { "type": "string", "enum": ["The request JSON is not well formed."] } } } ] } } } }, "orders.patch-422": { "properties": { "details": { "type": "array", "items": { "anyOf": [ { "title": "AMOUNT_MISMATCH", "properties": { "issue": { "type": "string", "enum": ["AMOUNT_MISMATCH"] }, "description": { "type": "string", "enum": [ "Should equal item_total + tax_total + shipping + handling + insurance - shipping_discount - discount." ] } } }, { "title": "CANNOT_BE_NEGATIVE", "properties": { "issue": { "type": "string", "enum": ["CANNOT_BE_NEGATIVE"] }, "description": { "type": "string", "enum": [ "Must be greater than or equal to 0. If the currency supports decimals, only two decimal place precision is supported." ] } } }, { "title": "CANNOT_BE_ZERO_OR_NEGATIVE", "properties": { "issue": { "type": "string", "enum": ["CANNOT_BE_ZERO_OR_NEGATIVE"] }, "description": { "type": "string", "enum": [ "Must be greater than zero. If the currency supports decimals, only two decimal place precision is supported." ] } } }, { "title": "CITY_REQUIRED", "properties": { "issue": { "type": "string", "enum": ["CITY_REQUIRED"] }, "description": { "type": "string", "enum": [ "The specified country requires a city (address.admin_area_2)." ] } } }, { "title": "DECIMAL_PRECISION", "properties": { "issue": { "type": "string", "enum": ["DECIMAL_PRECISION"] }, "description": { "type": "string", "enum": [ "If the currency supports decimals, only two decimal place precision is supported." ] } } }, { "title": "DONATION_ITEMS_NOT_SUPPORTED", "properties": { "issue": { "type": "string", "enum": ["DONATION_ITEMS_NOT_SUPPORTED"] }, "description": { "type": "string", "enum": [ "If 'purchase_unit' has \"DONATION\" as the 'items.category' then the Order can at most have one purchase_unit. Multiple purchase_units are not supported if either of them have at least one items with category as \"DONATION\"." ] } } }, { "title": "DUPLICATE_REFERENCE_ID", "properties": { "issue": { "type": "string", "enum": ["DUPLICATE_REFERENCE_ID"] }, "description": { "type": "string", "enum": [ "`reference_id` must be unique if multiple `purchase_unit` are provided." ] } } }, { "title": "INVALID_CURRENCY_CODE", "properties": { "issue": { "type": "string", "enum": ["INVALID_CURRENCY_CODE"] }, "description": { "type": "string", "enum": [ "Currency code is invalid or is not currently supported. Please refer https://developer.paypal.com/api/rest/reference/currency-codes/ for list of supported currency codes." ] } } }, { "title": "ITEM_TOTAL_MISMATCH", "properties": { "issue": { "type": "string", "enum": ["ITEM_TOTAL_MISMATCH"] }, "description": { "type": "string", "enum": [ "Should equal sum of (unit_amount * quantity) across all items for a given purchase_unit." ] } } }, { "title": "ITEM_TOTAL_REQUIRED", "properties": { "issue": { "type": "string", "enum": ["ITEM_TOTAL_REQUIRED"] }, "description": { "type": "string", "enum": [ "If item details are specified (items.unit_amount and items.quantity) corresponding amount.breakdown.item_total is required." ] } } }, { "title": "MAX_VALUE_EXCEEDED", "properties": { "issue": { "type": "string", "enum": ["MAX_VALUE_EXCEEDED"] }, "description": { "type": "string", "enum": [ "Should be less than or equal to 999999999999999.99." ] } } }, { "title": "INVALID_JSON_POINTER_FORMAT", "properties": { "issue": { "type": "string", "enum": ["INVALID_JSON_POINTER_FORMAT"] }, "description": { "type": "string", "enum": [ "Path should be a valid JSON Pointer https://tools.ietf.org/html/rfc6901 that references a location within the request where the operation is performed." ] } } }, { "title": "INVALID_PARAMETER", "properties": { "issue": { "type": "string", "enum": ["INVALID_PARAMETER"] }, "description": { "type": "string", "enum": ["Cannot be specified as part of the request."] } } }, { "title": "NOT_PATCHABLE", "properties": { "issue": { "type": "string", "enum": ["NOT_PATCHABLE"] }, "description": { "type": "string", "enum": ["Cannot be patched."] } } }, { "title": "TAX_TOTAL_MISMATCH", "properties": { "issue": { "type": "string", "enum": ["TAX_TOTAL_MISMATCH"] }, "description": { "type": "string", "enum": [ "Should equal sum of (tax * quantity) across all items for a given purchase_unit." ] } } }, { "title": "TAX_TOTAL_REQUIRED", "properties": { "issue": { "type": "string", "enum": ["TAX_TOTAL_REQUIRED"] }, "description": { "type": "string", "enum": [ "If item details are specified (items.tax_total and items.quantity) corresponding amount.breakdown.tax_total is required." ] } } }, { "title": "UNSUPPORTED_INTENT", "properties": { "issue": { "type": "string", "enum": ["UNSUPPORTED_INTENT"] }, "description": { "type": "string", "enum": [ "`intent=AUTHORIZE` is not supported for multiple purchase units. Only `intent=CAPTURE` is supported." ] } } }, { "title": "UNSUPPORTED_INTENT_FOR_KYC_INCOMPLETE_PAYEE", "properties": { "issue": { "type": "string", "enum": ["UNSUPPORTED_INTENT_FOR_KYC_INCOMPLETE_PAYEE"] }, "description": { "type": "string", "enum": [ "`intent=AUTHORIZE` is not supported due to payee's incomplete KYC, while their partner is enabled for Progressive Onboarding. Only `intent=CAPTURE` is supported." ] } } }, { "title": "UNSUPPORTED_PATCH_PARAMETER_VALUE", "properties": { "issue": { "type": "string", "enum": ["UNSUPPORTED_PATCH_PARAMETER_VALUE"] }, "description": { "type": "string", "enum": [ "The value specified for this field is not currently supported." ] } } }, { "title": "PATCH_VALUE_REQUIRED", "properties": { "issue": { "type": "string", "enum": ["PATCH_VALUE_REQUIRED"] }, "description": { "type": "string", "enum": [ "Please specify a 'value' to for the field that is being patched." ] } } }, { "title": "PATCH_PATH_REQUIRED", "properties": { "issue": { "type": "string", "enum": ["PATCH_PATH_REQUIRED"] }, "description": { "type": "string", "enum": [ "Please specify a 'path' for the field for which the operation needs to be performed." ] } } }, { "title": "PAYEE_ACCOUNT_LOCKED_OR_CLOSED", "properties": { "issue": { "type": "string", "enum": ["PAYEE_ACCOUNT_LOCKED_OR_CLOSED"] }, "description": { "type": "string", "enum": ["The merchant account is locked or closed."] } } }, { "title": "PAYEE_ACCOUNT_RESTRICTED", "properties": { "issue": { "type": "string", "enum": ["PAYEE_ACCOUNT_RESTRICTED"] }, "description": { "type": "string", "enum": ["The merchant account is restricted."] } } }, { "title": "PAYEE_FX_RATE_ID_EXPIRED", "properties": { "issue": { "type": "string", "enum": ["PAYEE_FX_RATE_ID_EXPIRED"] }, "description": { "type": "string", "enum": [ "The specified FX Rate ID has expired. Please specify a different FX Rate Id and try the request again. Alternately, remove the FX Rate ID to process the request using the default exchange rate." ] } } }, { "title": "PAYEE_FX_RATE_ID_CURRENCY_MISMATCH", "properties": { "issue": { "type": "string", "enum": ["PAYEE_FX_RATE_ID_CURRENCY_MISMATCH"] }, "description": { "type": "string", "enum": [ "The specified FX Rate ID is for a currency that does not match with the currency of this request. Please specify a different FX Rate ID and try the request again. Alternately, remove the FX Rate ID to process the request using the default exchange rate." ] } } }, { "title": "INVALID_FX_RATE_ID", "properties": { "issue": { "type": "string", "enum": ["INVALID_FX_RATE_ID"] }, "description": { "type": "string", "enum": [ "The specific FX Rate ID is not valid. This could be either because we are not able to look up the FX Rate based on this ID or it could be because the ID belongs to another API Caller." ] } } }, { "title": "PLATFORM_FEES_NOT_SUPPORTED", "properties": { "issue": { "type": "string", "enum": ["PLATFORM_FEES_NOT_SUPPORTED"] }, "description": { "type": "string", "enum": [ "The API Caller is not enabled to process transactions by specifying 'platform_fees'. Please work with your PayPal Account Manager to enable this option for your account." ] } } }, { "title": "INVALID_PLATFORM_FEES_ACCOUNT", "properties": { "issue": { "type": "string", "enum": ["INVALID_PLATFORM_FEES_ACCOUNT"] }, "description": { "type": "string", "enum": [ "The specified platform_fees payee account is either invalid or account setup is incomplete.Please work with your PayPal Account Manager to enable this option for your account." ] } } }, { "title": "INVALID_PLATFORM_FEES_AMOUNT", "properties": { "issue": { "type": "string", "enum": ["INVALID_PLATFORM_FEES_AMOUNT"] }, "description": { "type": "string", "enum": [ "The platform_fees amount cannot be greater than order amount." ] } } }, { "title": "POSTAL_CODE_REQUIRED", "properties": { "issue": { "type": "string", "enum": ["POSTAL_CODE_REQUIRED"] }, "description": { "type": "string", "enum": ["The specified country requires a postal code."] } } }, { "title": "REFERENCE_ID_NOT_FOUND", "properties": { "issue": { "type": "string", "enum": ["REFERENCE_ID_NOT_FOUND"] }, "description": { "type": "string", "enum": [ "Filter expression value is incorrect. Please check the value of the reference_id and try again." ] } } }, { "title": "REFERENCE_ID_REQUIRED", "properties": { "issue": { "type": "string", "enum": ["REFERENCE_ID_REQUIRED"] }, "description": { "type": "string", "enum": [ "'reference_id' is required for each 'purchase_unit' if multiple 'purchase_unit' are provided." ] } } }, { "title": "MULTI_CURRENCY_ORDER", "properties": { "issue": { "type": "string", "enum": ["MULTI_CURRENCY_ORDER"] }, "description": { "type": "string", "enum": [ "Multiple differing values of currency_code are not supported. Entire Order request must have the same currency_code." ] } } }, { "title": "INVALID_SHIPPING_OPTION_ID", "properties": { "issue": { "type": "string", "enum": ["INVALID_SHIPPING_OPTION_ID"] }, "description": { "type": "string", "enum": [ "The items.shipping.options_ids[].id does not exist in purchase_units.shipping.options[]. Please ensure that all ids used in options_ids are first defined in purchase_units.shipping.options[]." ] } } }, { "title": "INVALID_DELIVERY_ESTIMATE", "properties": { "issue": { "type": "string", "enum": ["INVALID_DELIVERY_ESTIMATE"] }, "description": { "type": "string", "enum": [ "The provided `delivery_time_max` must be greater than the `delivery_time_min`, and vice versa." ] } } }, { "title": "INELIGIBLE_SHIPPING_OPTION", "properties": { "issue": { "type": "string", "enum": ["INELIGIBLE_SHIPPING_OPTION"] }, "description": { "type": "string", "enum": [ "One or more shipping options cannot be used in conjunction with this Order." ] } } }, { "title": "MISSING_SHIPPING_CALL_BACK_CONFIGURATION", "properties": { "issue": { "type": "string", "enum": ["MISSING_SHIPPING_CALL_BACK_CONFIGURATION"] }, "description": { "type": "string", "enum": [ "`payment_source.paypal.experience_context.order_update_callback_config` is mandatory for one or more shipping.options provided in the request." ] } } }, { "title": "MISSING_ITEM_SHIPPING_OPTIONS", "properties": { "issue": { "type": "string", "enum": ["MISSING_ITEM_SHIPPING_OPTIONS"] }, "description": { "type": "string", "enum": [ "All items in the purchase_unit must have `options_ids` defined if any item in the Order has `item[].shipping.options_ids` defined." ] } } }, { "title": "SHIPPING_OPTION_NOT_SELECTED", "properties": { "issue": { "type": "string", "enum": ["SHIPPING_OPTION_NOT_SELECTED"] }, "description": { "type": "string", "enum": [ "At least one of the shipping.option should be set to 'selected = true'." ] } } }, { "title": "SHIPPING_OPTIONS_NOT_SUPPORTED", "properties": { "issue": { "type": "string", "enum": ["SHIPPING_OPTIONS_NOT_SUPPORTED"] }, "description": { "type": "string", "enum": [ "Shipping options are not supported when `shipping.type` is specified or when 'payment_source.paypal.experience_context.shipping_preference' is set as 'NO_SHIPPING' or 'SET_PROVIDED_ADDRESS'." ] } } }, { "title": "MULTIPLE_SHIPPING_OPTION_SELECTED", "properties": { "issue": { "type": "string", "enum": ["MULTIPLE_SHIPPING_OPTION_SELECTED"] }, "description": { "type": "string", "enum": [ "Only one shipping.option can be set to 'selected = true'." ] } } }, { "title": "DUPLICATE_SHIPPING_OPTION_ID", "properties": { "issue": { "type": "string", "enum": ["DUPLICATE_SHIPPING_OPTION_ID"] }, "description": { "type": "string", "enum": [ "Please specify a unique shipping option id for each shipping option provided in the request and try again." ] } } }, { "title": "ORDER_ALREADY_COMPLETED", "properties": { "issue": { "type": "string", "enum": ["ORDER_ALREADY_COMPLETED"] }, "description": { "type": "string", "enum": [ "The order cannot be patched after it is completed." ] } } }, { "title": "CANNOT_MODIFY_INTENT", "properties": { "issue": { "type": "string", "enum": ["CANNOT_MODIFY_INTENT"] }, "description": { "type": "string", "enum": [ "The value of 'intent' cannot be changed. Please create a new order." ] } } }, { "title": "PREFERRED_SHIPPING_OPTION_AMOUNT_MISMATCH", "properties": { "issue": { "type": "string", "enum": ["PREFERRED_SHIPPING_OPTION_AMOUNT_MISMATCH"] }, "description": { "type": "string", "enum": [ "The amount provided in the preferred shipping option should match the amount provided in amount breakdown" ] } } }, { "title": "AMOUNT_CHANGE_NOT_ALLOWED", "properties": { "issue": { "type": "string", "enum": ["AMOUNT_CHANGE_NOT_ALLOWED"] }, "description": { "type": "string", "enum": [ "The amount specified is different from the amount authorized by payer." ] } } }, { "title": "DELAYED_DISBURSEMENT_NOT_SUPPORTED", "properties": { "issue": { "type": "string", "enum": ["DELAYED_DISBURSEMENT_NOT_SUPPORTED"] }, "description": { "type": "string", "enum": [ "The API Caller is not enabled to process transactions by specifying disbursement mode as delayed." ] } } }, { "title": "DELAYED_DISBURSEMENT_NOT_SUPPORTED_FOR_KYC_INCOMPLETE_PAYEE", "properties": { "issue": { "type": "string", "enum": [ "DELAYED_DISBURSEMENT_NOT_SUPPORTED_FOR_KYC_INCOMPLETE_PAYEE" ] }, "description": { "type": "string", "enum": [ "The Delayed disbursement is not supported due to payee's incomplete KYC, while their partner is enabled for Progressive Onboarding." ] } } }, { "title": "PARTNER_SETTLEMENT_NOT_SUPPORTED_FOR_KYC_INCOMPLETE_PAYEE", "properties": { "issue": { "type": "string", "enum": [ "PARTNER_SETTLEMENT_NOT_SUPPORTED_FOR_KYC_INCOMPLETE_PAYEE" ] }, "description": { "type": "string", "enum": [ "Partner settlement is not supported due to payee's incomplete KYC, while their partner is enabled for Progressive Onboarding." ] } } }, { "title": "MULTIPLE_PURCHASE_UNITS_NOT_SUPPORTED_FOR_PAYMENT_SOURCE", "properties": { "issue": { "type": "string", "enum": [ "MULTIPLE_PURCHASE_UNITS_NOT_SUPPORTED_FOR_PAYMENT_SOURCE" ] }, "description": { "type": "string", "enum": [ "The provided payment source cannot be used to pay for the multiple purchase units order." ] } } } ] } } } }, "orders.track.create-400": { "properties": { "details": { "type": "array", "items": { "anyOf": [ { "title": "MISSING_REQUIRED_PARAMETER", "properties": { "issue": { "type": "string", "enum": ["MISSING_REQUIRED_PARAMETER"] }, "description": { "type": "string", "enum": ["A required field / parameter is missing."] } } }, { "title": "INVALID_STRING_LENGTH", "properties": { "issue": { "type": "string", "enum": ["INVALID_STRING_LENGTH"] }, "description": { "type": "string", "enum": [ "The value of a field is either too short or too long." ] } } }, { "title": "INVALID_PARAMETER_VALUE", "properties": { "issue": { "type": "string", "enum": ["INVALID_PARAMETER_VALUE"] }, "description": { "type": "string", "enum": ["A parameter value is not valid."] } } }, { "title": "INVALID_PARAMETER_SYNTAX", "properties": { "issue": { "type": "string", "enum": ["INVALID_PARAMETER_SYNTAX"] }, "description": { "type": "string", "enum": [ "The value of a field does not conform to the expected format." ] } } } ] } } } }, "orders.track.create-403": { "properties": { "details": { "type": "array", "items": { "anyOf": [ { "title": "PERMISSION_DENIED", "properties": { "issue": { "type": "string", "enum": ["PERMISSION_DENIED"] }, "description": { "type": "string", "enum": [ "You do not have permission to access or perform operations on this resource." ] } } } ] } } } }, "orders.track.create-422": { "properties": { "details": { "type": "array", "items": { "anyOf": [ { "title": "INVALID_TRACKING_NUMBER", "properties": { "issue": { "type": "string", "enum": ["INVALID_TRACKING_NUMBER"] }, "description": { "type": "string", "enum": [ "Use a valid tracking number. It must not be empty, contain spaces or tab characters" ] } } }, { "title": "CAPTURE_STATUS_NOT_VALID", "properties": { "issue": { "type": "string", "enum": ["CAPTURE_STATUS_NOT_VALID"] }, "description": { "type": "string", "enum": [ "Invalid capture status. Tracker information can only be added to captures in `COMPLETED` state." ] } } }, { "title": "ITEM_SKU_MISMATCH", "properties": { "issue": { "type": "string", "enum": ["ITEM_SKU_MISMATCH"] }, "description": { "type": "string", "enum": [ "Item sku must match one of the items sku that was provided during order creation." ] } } }, { "title": "CAPTURE_ID_NOT_FOUND", "properties": { "issue": { "type": "string", "enum": ["CAPTURE_ID_NOT_FOUND"] }, "description": { "type": "string", "enum": [ "Specified capture ID does not exist. Check the capture ID and try again." ] } } }, { "title": "MSP_NOT_SUPPORTED", "properties": { "issue": { "type": "string", "enum": ["MSP_NOT_SUPPORTED"] }, "description": { "type": "string", "enum": [ "Multiple purchase units are not supported for this operation." ] } } } ] } } } }, "orders.trackers.patch-400": { "properties": { "details": { "type": "array", "items": { "anyOf": [ { "title": "FIELD_NOT_PATCHABLE", "properties": { "issue": { "type": "string", "enum": ["FIELD_NOT_PATCHABLE"] }, "description": { "type": "string", "enum": ["Field cannot be patched."] } } }, { "title": "INVALID_PARAMETER_VALUE", "properties": { "issue": { "type": "string", "enum": ["INVALID_PARAMETER_VALUE"] }, "description": { "type": "string", "enum": ["The value of a field is invalid."] } } }, { "title": "MISSING_REQUIRED_PARAMETER", "properties": { "issue": { "type": "string", "enum": ["MISSING_REQUIRED_PARAMETER"] }, "description": { "type": "string", "enum": ["A required field or parameter is missing."] } } }, { "title": "INVALID_STRING_LENGTH", "properties": { "issue": { "type": "string", "enum": ["INVALID_STRING_LENGTH"] }, "description": { "type": "string", "enum": [ "The value of a field is either too short or too long." ] } } }, { "title": "INVALID_PATCH_OPERATION", "properties": { "issue": { "type": "string", "enum": ["INVALID_PATCH_OPERATION"] }, "description": { "type": "string", "enum": [ "The operation cannot be honored. Cannot add a property that's already present, use replace. Cannot remove a property thats not present, use add. Cannot replace a property thats not present, use add." ] } } }, { "title": "MALFORMED_REQUEST_JSON", "properties": { "issue": { "type": "string", "enum": ["MALFORMED_REQUEST_JSON"] }, "description": { "type": "string", "enum": ["The request JSON is not well formed."] } } } ] } } } }, "orders.trackers.patch-403": { "properties": { "details": { "type": "array", "items": { "anyOf": [ { "title": "PERMISSION_DENIED", "properties": { "issue": { "type": "string", "enum": ["PERMISSION_DENIED"] }, "description": { "type": "string", "enum": [ "You do not have permission to access or perform operations on this resource." ] } } } ] } } } }, "orders.trackers.patch-404": { "properties": { "details": { "type": "array", "items": { "anyOf": [ { "title": "TRACKER_ID_NOT_FOUND", "properties": { "issue": { "type": "string", "enum": ["TRACKER_ID_NOT_FOUND"] }, "description": { "type": "string", "enum": [ "Specified tracker ID does not exist. Check the tracker ID and try again." ] } } } ] } } } }, "orders.trackers.patch-422": { "properties": { "details": { "type": "array", "items": { "anyOf": [ { "title": "INVALID_JSON_POINTER_FORMAT", "properties": { "issue": { "type": "string", "enum": ["INVALID_JSON_POINTER_FORMAT"] }, "description": { "type": "string", "enum": [ "Path should be a valid [JSON Pointer](https://tools.ietf.org/html/rfc6901) that references a location within the request where the operation is performed." ] } } }, { "title": "NOT_PATCHABLE", "properties": { "issue": { "type": "string", "enum": ["NOT_PATCHABLE"] }, "description": { "type": "string", "enum": ["Cannot be patched."] } } }, { "title": "PATCH_VALUE_REQUIRED", "properties": { "issue": { "type": "string", "enum": ["PATCH_VALUE_REQUIRED"] }, "description": { "type": "string", "enum": ["Specify a `value` for the field being patched."] } } }, { "title": "PATCH_PATH_REQUIRED", "properties": { "issue": { "type": "string", "enum": ["PATCH_PATH_REQUIRED"] }, "description": { "type": "string", "enum": [ "Specify a `value` for the field in which the operation needs to be performed." ] } } }, { "title": "ITEM_SKU_MISMATCH", "properties": { "issue": { "type": "string", "enum": ["ITEM_SKU_MISMATCH"] }, "description": { "type": "string", "enum": [ "Item sku must match one of the items sku that was provided during order creation." ] } } }, { "title": "MAX_TRACKER_UPDATE_COUNT_EXCEEDED", "properties": { "issue": { "type": "string", "enum": ["MAX_TRACKER_UPDATE_COUNT_EXCEEDED"] }, "description": { "type": "string", "enum": [ "Exceeding the permissible number of updates; tracker update operations do not support more than 15 updates." ] } } } ] } } } }, "p24": { "type": "object", "title": "P24 payment object", "description": "Information used to pay using P24(Przelewy24).", "properties": { "name": { "description": "The name of the account holder associated with this payment method.", "$ref": "#/components/schemas/full_name" }, "email": { "description": "The email address of the account holder associated with this payment method.", "$ref": "#/components/schemas/email_address" }, "country_code": { "description": "The two-character ISO 3166-1 country code.", "$ref": "#/components/schemas/country_code-2" }, "payment_descriptor": { "type": "string", "minLength": 1, "maxLength": 2000, "description": "P24 generated payment description." }, "method_id": { "type": "string", "minLength": 1, "maxLength": 300, "description": "Numeric identifier of the payment scheme or bank used for the payment." }, "method_description": { "type": "string", "minLength": 1, "maxLength": 2000, "description": "Friendly name of the payment scheme or bank used for the payment." } } }, "p24_request": { "type": "object", "title": "P24 payment request", "description": "Information needed to pay using P24 (Przelewy24).", "properties": { "name": { "description": "The name of the account holder associated with this payment method.", "$ref": "#/components/schemas/full_name" }, "email": { "description": "The email address of the account holder associated with this payment method.", "$ref": "#/components/schemas/email_address" }, "country_code": { "description": "The two-character ISO 3166-1 country code.", "$ref": "#/components/schemas/country_code-2" }, "experience_context": { "description": "Customizes the payer experience during the approval process for the payment.", "$ref": "#/components/schemas/experience_context_base" } }, "required": ["name", "email", "country_code"] }, "pares_status": { "type": "string", "minLength": 1, "maxLength": 255, "pattern": "^[0-9A-Z_]+$", "description": "Transactions status result identifier. The outcome of the issuer's authentication.", "x-enumDescriptions": [ { "value": "Y", "description": "Successful authentication." }, { "value": "N", "description": "Failed authentication / account not verified / transaction denied." }, { "value": "U", "description": "Unable to complete authentication." }, { "value": "A", "description": "Successful attempts transaction." }, { "value": "C", "description": "Challenge required for authentication." }, { "value": "R", "description": "Authentication rejected (merchant must not submit for authorization)." }, { "value": "D", "description": "Challenge required; decoupled authentication confirmed." }, { "value": "I", "description": "Informational only; 3DS requestor challenge preference acknowledged." } ], "enum": ["Y", "N", "U", "A", "C", "R", "D", "I"] }, "participant_metadata": { "type": "object", "title": "Participant metadata", "description": "Profile information of the sender or receiver.", "properties": { "ip_address": { "description": "The consumer's IP address, which can be represented in either IPv4 or IPv6 format.", "$ref": "#/components/schemas/ip_address" } } }, "patch": { "type": "object", "title": "Patch", "description": "The JSON patch object to apply partial updates to resources.", "properties": { "op": { "type": "string", "description": "The operation.", "x-enumDescriptions": [ { "value": "add", "description": "Depending on the target location reference, completes one of these functions:The value parameter defines the value to add. For more information, see 4.1. add." }, { "value": "remove", "description": "Removes the value at the target location. For the operation to succeed, the target location must exist. For more information, see 4.2. remove." }, { "value": "replace", "description": "Replaces the value at the target location with a new value. The operation object must contain a value parameter that defines the replacement value. For the operation to succeed, the target location must exist. For more information, see 4.3. replace." }, { "value": "move", "description": "Removes the value at a specified location and adds it to the target location. The operation object must contain a from parameter, which is a string that contains a JSON pointer value that references the location in the target document from which to move the value. For the operation to succeed, the from location must exist. For more information, see 4.4. move." }, { "value": "copy", "description": "Copies the value at a specified location to the target location. The operation object must contain a from parameter, which is a string that contains a JSON pointer value that references the location in the target document from which to copy the value. For the operation to succeed, the from location must exist. For more information, see 4.5. copy." }, { "value": "test", "description": "Tests that a value at the target location is equal to a specified value. The operation object must contain a value parameter that defines the value to compare to the target location's value. For the operation to succeed, the target location must be equal to the value value. For test, equal indicates that the value at the target location and the value that value defines are of the same JSON type. The data type of the value determines how equality is defined:
TypeConsidered equal if both values
stringsContain the same number of Unicode characters and their code points are byte-by-byte equal.
numbersAre numerically equal.
arraysContain the same number of values, and each value is equal to the value at the corresponding position in the other array, by using these type-specific rules.
objectsContain the same number of parameters, and each parameter is equal to a parameter in the other object, by comparing their keys (as strings) and their values (by using these type-specific rules).
literals (false, true, and null)Are the same. The comparison is a logical comparison. For example, whitespace between the parameter values of an array is not significant. Also, ordering of the serialization of object parameters is not significant.
For more information, see 4.6. test." } ], "enum": ["add", "remove", "replace", "move", "copy", "test"] }, "path": { "type": "string", "description": "The JSON Pointer to the target document location at which to complete the operation." }, "value": { "title": "Patch Value", "description": "The value to apply. The remove, copy, and move operations do not require a value. Since JSON Patch allows any type for value, the type property is not specified." }, "from": { "type": "string", "description": "The JSON Pointer to the target document location from which to move the value. Required for the move operation." } }, "required": ["op"] }, "patch_request": { "type": "array", "title": "Patch Request", "description": "An array of JSON patch objects to apply partial updates to resources.", "minItems": 0, "maxItems": 32767, "items": { "$ref": "#/components/schemas/patch" } }, "payee": { "type": "object", "title": "Payee", "description": "The merchant who receives the funds and fulfills the order. The merchant is also known as the payee.", "allOf": [ { "$ref": "#/components/schemas/payee_base" }, { "properties": {} } ] }, "payee_base": { "type": "object", "title": "Payee Base", "description": "The details for the merchant who receives the funds and fulfills the order. The merchant is also known as the payee.", "properties": { "email_address": { "description": "The email address of merchant.", "$ref": "#/components/schemas/email" }, "merchant_id": { "description": "The encrypted PayPal account ID of the merchant.", "$ref": "#/components/schemas/account_id" } } }, "payee_payment_method_preference": { "type": "string", "description": "The merchant-preferred payment methods.", "minLength": 1, "maxLength": 255, "pattern": "^[0-9A-Z_]+$", "default": "UNRESTRICTED", "x-enumDescriptions": [ { "value": "UNRESTRICTED", "description": "Accepts any type of payment from the customer.", "default": true }, { "value": "IMMEDIATE_PAYMENT_REQUIRED", "description": "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 `pending` status." } ], "enum": ["UNRESTRICTED", "IMMEDIATE_PAYMENT_REQUIRED"] }, "payer": { "allOf": [ { "$ref": "#/components/schemas/payer_base" }, { "properties": { "name": { "description": "The name of the party.", "type": "object", "title": "Name", "properties": { "given_name": { "type": "string", "description": "When the party is a person, the party's given, or first, name.", "maxLength": 140 }, "surname": { "type": "string", "description": "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.", "maxLength": 140 } } }, "phone": { "description": "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 `phone.phone_number` supports only `national_number`.", "$ref": "#/components/schemas/phone_with_type" }, "birth_date": { "description": "The birth date of the payer in `YYYY-MM-DD` format.", "$ref": "#/components/schemas/date_no_time" }, "tax_info": { "description": "The tax information of the payer. Required only for Brazilian payer's. Both `tax_id` and `tax_id_type` are required.", "$ref": "#/components/schemas/tax_info" }, "address": { "description": "The portable international postal address. Maps to [AddressValidationMetadata](https://github.com/googlei18n/libaddressinput/wiki/AddressValidationMetadata) and HTML 5.1 [Autofilling form controls: the autocomplete attribute](https://www.w3.org/TR/html51/sec-forms.html#autofilling-form-controls-the-autocomplete-attribute).", "type": "object", "title": "Portable Postal Address (Medium-Grained)", "properties": { "address_line_1": { "type": "string", "description": "The first line of the address, such as number and street, for example, `173 Drury Lane`. Needed for data entry, and Compliance and Risk checks. This field needs to pass the full address.", "maxLength": 300 }, "address_line_2": { "type": "string", "description": "The second line of the address, for example, a suite or apartment number.", "maxLength": 300 }, "admin_area_2": { "type": "string", "description": "A city, town, or village. Smaller than `admin_area_level_1`.", "maxLength": 120 }, "admin_area_1": { "type": "string", "description": "The highest-level sub-division in a country, which is usually a province, state, or ISO-3166-2 subdivision. This data is formatted for postal delivery, for example, `CA` and not `California`. Value, by country, is:", "maxLength": 300 }, "postal_code": { "type": "string", "description": "The postal code, which is the ZIP code or equivalent. Typically required for countries with a postal code or an equivalent. See [postal code](https://en.wikipedia.org/wiki/Postal_code).", "maxLength": 60 }, "country_code": { "$ref": "#/components/schemas/country_code" } }, "required": ["country_code"] } } }, { "type": "object", "title": "Payer", "description": "The customer who approves and pays for the order. The customer is also known as the payer.", "format": "payer_v1" } ] }, "payer_base": { "type": "object", "title": "Payer Base", "description": "The customer who approves and pays for the order. The customer is also known as the payer.", "properties": { "email_address": { "description": "The email address of the payer.", "$ref": "#/components/schemas/email" }, "payer_id": { "description": "The PayPal-assigned ID for the payer.", "readOnly": true, "$ref": "#/components/schemas/account_id" } } }, "payment_collection": { "type": "object", "title": "Payment Collection", "description": "The collection of payments, or transactions, for a purchase unit in an order. For example, authorized payments, captured payments, and refunds.", "properties": { "authorizations": { "$ref": "#/components/schemas/authorization_with_additional_data_list" }, "captures": { "$ref": "#/components/schemas/capture_list" }, "refunds": { "$ref": "#/components/schemas/refund_list" } } }, "payment_initiator": { "type": "string", "minLength": 1, "maxLength": 255, "pattern": "^[0-9A-Z_]+$", "description": "The person or party who initiated or triggered the payment.", "x-enumDescriptions": [ { "value": "CUSTOMER", "description": "Payment is initiated with the active engagement of the customer. e.g. a customer checking out on a merchant website." }, { "value": "MERCHANT", "description": "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." } ], "enum": ["CUSTOMER", "MERCHANT"] }, "payment_instruction": { "type": "object", "title": "Payment Instruction", "description": "Any additional payment instructions to be consider during payment processing. This processing instruction is applicable for Capturing an order or Authorizing an Order.", "properties": { "platform_fees": { "$ref": "#/components/schemas/platform_fee_list" }, "disbursement_mode": { "description": "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.", "$ref": "#/components/schemas/disbursement_mode" }, "payee_pricing_tier_id": { "type": "string", "description": "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.", "minLength": 1, "maxLength": 20, "pattern": "^.*$" }, "payee_receivable_fx_rate_id": { "type": "string", "description": "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.", "maxLength": 4000, "minLength": 1, "pattern": "^.*$" } } }, "payment_method": { "type": "object", "description": "The customer and merchant payment preferences.", "title": "Payment Method", "properties": { "payee_preferred": { "$ref": "#/components/schemas/payee_payment_method_preference" }, "standard_entry_class_code": { "type": "string", "description": "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.", "default": "WEB", "minLength": 3, "maxLength": 255, "x-enumDescriptions": [ { "value": "TEL", "description": "The API caller (merchant/partner) accepts authorization and payment information from a consumer over the telephone." }, { "value": "WEB", "description": "The API caller (merchant/partner) accepts Debit transactions from a consumer on their website." }, { "value": "CCD", "description": "Cash concentration and disbursement for corporate debit transaction. Used to disburse or consolidate funds. Entries are usually Optional high-dollar, low-volume, and time-critical. (e.g. intra-company transfers or invoice payments to suppliers)." }, { "value": "PPD", "description": "Prearranged payment and deposit entries. Used for debit payments authorized by a consumer account holder, and usually initiated by a company. These are usually recurring debits (such as insurance premiums)." } ], "enum": ["TEL", "WEB", "CCD", "PPD"] } } }, "payment_source": { "type": "object", "title": "Payment Source", "description": "The payment source definition.", "properties": { "card": { "$ref": "#/components/schemas/card_request" }, "token": { "$ref": "#/components/schemas/token" }, "paypal": { "description": "Indicates that PayPal Wallet is the payment source. Main use of this selection is to provide additional instructions associated with this choice like vaulting.", "$ref": "#/components/schemas/paypal_wallet" }, "bancontact": { "description": "Bancontact is the most popular online payment in Belgium. [More Details](https://www.bancontact.com/).", "$ref": "#/components/schemas/bancontact_request" }, "blik": { "description": "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](https://blikmobile.pl/).", "$ref": "#/components/schemas/blik_request" }, "eps": { "description": "The eps transfer is an online payment method developed by many Austrian banks. [More Details](https://www.eps-ueberweisung.at/).", "$ref": "#/components/schemas/eps_request" }, "giropay": { "description": "Giropay is an Internet payment System in Germany, based on online banking. [More Details](https://giropay.de/).", "$ref": "#/components/schemas/giropay_request" }, "ideal": { "description": "The Dutch payment method iDEAL is an online payment method that enables consumers to pay online through their own bank. [More Details](https://www.ideal.nl/).", "$ref": "#/components/schemas/ideal_request" }, "swish": { "description": "The Sweden payment method Swish is an online payment method that enables consumers to pay online through their own bank.", "$ref": "#/components/schemas/swish_request" }, "pix": { "description": "PIX is a local payment method in Brazil, that enables consumers to pay online through their own bank.", "$ref": "#/components/schemas/pix_request" }, "mybank": { "description": "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](https://www.mybank.eu/).", "$ref": "#/components/schemas/mybank_request" }, "p24": { "description": "P24 (Przelewy24) is a secure and fast online bank transfer service linked to all the major banks in Poland. [More Details](https://www.przelewy24.pl/).", "$ref": "#/components/schemas/p24_request" }, "sofort": { "description": "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](https://www.klarna.com/sofort/).", "$ref": "#/components/schemas/sofort_request" }, "trustly": { "description": "Trustly is a payment method that allows customers to shop and pay from their bank account. [More Details](https://www.trustly.net/).", "$ref": "#/components/schemas/trustly_request" }, "apple_pay": { "description": "ApplePay payment source, allows buyer to pay using ApplePay, both on Web as well as on Native.", "$ref": "#/components/schemas/apple_pay_request" }, "google_pay": { "description": "Google Pay payment source, allows buyer to pay using Google Pay.", "$ref": "#/components/schemas/google_pay_request" }, "venmo": { "description": "Information needed to indicate that Venmo is being used to fund the payment.", "$ref": "#/components/schemas/venmo_wallet_request" }, "crypto": { "description": "Indicates that Crypto Wallet is the payment source.", "$ref": "#/components/schemas/crypto_request" } } }, "payment_source_response": { "type": "object", "title": "Payment Source Response", "description": "The payment source used to fund the payment.", "properties": { "card": { "$ref": "#/components/schemas/card_response" }, "paypal": { "$ref": "#/components/schemas/paypal_wallet_response" }, "bancontact": { "$ref": "#/components/schemas/bancontact" }, "blik": { "$ref": "#/components/schemas/blik" }, "eps": { "$ref": "#/components/schemas/eps" }, "giropay": { "$ref": "#/components/schemas/giropay" }, "ideal": { "$ref": "#/components/schemas/ideal" }, "swish": { "$ref": "#/components/schemas/swish" }, "mybank": { "$ref": "#/components/schemas/mybank" }, "p24": { "$ref": "#/components/schemas/p24" }, "sofort": { "$ref": "#/components/schemas/sofort" }, "trustly": { "$ref": "#/components/schemas/trustly" }, "apple_pay": { "$ref": "#/components/schemas/apple_pay" }, "google_pay": { "$ref": "#/components/schemas/google_pay" }, "venmo": { "$ref": "#/components/schemas/venmo_wallet_response" }, "pix": { "$ref": "#/components/schemas/pix" }, "crypto": { "$ref": "#/components/schemas/crypto" } } }, "paypal_wallet": { "type": "object", "title": "PayPal Wallet", "description": "A resource that identifies a PayPal Wallet is used for payment.", "properties": { "vault_id": { "description": "The PayPal-generated ID for the payment_source stored within the Vault.", "$ref": "#/components/schemas/vault_id" }, "email_address": { "description": "The email address of the PayPal account holder.", "$ref": "#/components/schemas/email" }, "name": { "description": "The name of the party.", "type": "object", "title": "Name", "properties": { "given_name": { "type": "string", "description": "When the party is a person, the party's given, or first, name.", "maxLength": 140 }, "surname": { "type": "string", "description": "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.", "maxLength": 140 } } }, "phone": { "description": "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 `phone.phone_number` supports only `national_number`.", "$ref": "#/components/schemas/phone_with_type" }, "birth_date": { "description": "The birth date of the PayPal account holder in `YYYY-MM-DD` format.", "$ref": "#/components/schemas/date_no_time" }, "tax_info": { "description": "The tax information of the PayPal account holder. Required only for Brazilian PayPal account holder's. Both `tax_id` and `tax_id_type` are required.", "$ref": "#/components/schemas/tax_info" }, "address": { "description": "The portable international postal address. Maps to [AddressValidationMetadata](https://github.com/googlei18n/libaddressinput/wiki/AddressValidationMetadata) and HTML 5.1 [Autofilling form controls: the autocomplete attribute](https://www.w3.org/TR/html51/sec-forms.html#autofilling-form-controls-the-autocomplete-attribute).", "type": "object", "title": "Portable Postal Address (Medium-Grained)", "properties": { "address_line_1": { "type": "string", "description": "The first line of the address, such as number and street, for example, `173 Drury Lane`. Needed for data entry, and Compliance and Risk checks. This field needs to pass the full address.", "maxLength": 300 }, "address_line_2": { "type": "string", "description": "The second line of the address, for example, a suite or apartment number.", "maxLength": 300 }, "admin_area_2": { "type": "string", "description": "A city, town, or village. Smaller than `admin_area_level_1`.", "maxLength": 120 }, "admin_area_1": { "type": "string", "description": "The highest-level sub-division in a country, which is usually a province, state, or ISO-3166-2 subdivision. This data is formatted for postal delivery, for example, `CA` and not `California`. Value, by country, is:", "maxLength": 300 }, "postal_code": { "type": "string", "description": "The postal code, which is the ZIP code or equivalent. Typically required for countries with a postal code or an equivalent. See [postal code](https://en.wikipedia.org/wiki/Postal_code).", "maxLength": 60 }, "country_code": { "$ref": "#/components/schemas/country_code" } }, "required": ["country_code"] }, "attributes": { "description": "Additional attributes associated with the use of this wallet.", "$ref": "#/components/schemas/paypal_wallet_attributes" }, "experience_context": { "$ref": "#/components/schemas/paypal_wallet_experience_context" }, "billing_agreement_id": { "$ref": "#/components/schemas/billing_agreement_id" }, "stored_credential": { "$ref": "#/components/schemas/paypal_wallet_stored_credential" } } }, "paypal_wallet_attributes": { "type": "object", "title": "PayPal Wallet Attributes", "description": "Additional attributes associated with the use of this PayPal Wallet.", "properties": { "customer": { "$ref": "#/components/schemas/paypal_wallet_customer" }, "vault": { "allOf": [ { "$ref": "#/components/schemas/vault_instruction_base" }, { "properties": { "description": { "type": "string", "description": "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.", "minLength": 1, "maxLength": 128 }, "usage_pattern": { "title": "PayPal Payment Token Usage Pattern", "type": "string", "description": "Expected business/pricing model for the billing agreement.", "minLength": 1, "maxLength": 30, "x-enumDescriptions": [ { "value": "IMMEDIATE", "description": "On-demand instant payments – non-recurring, pre-paid, variable amount, variable frequency." }, { "value": "DEFERRED", "description": "Pay after use, non-recurring post-paid, variable amount, irregular frequency." }, { "value": "RECURRING_PREPAID", "description": "Pay upfront fixed or variable amount on a fixed date before the goods/service is delivered." }, { "value": "RECURRING_POSTPAID", "description": "Pay on a fixed date based on usage or consumption after the goods/service is delivered." }, { "value": "THRESHOLD_PREPAID", "description": "Charge payer when the set amount is reached or monthly billing cycle, whichever comes first, before the goods/service is delivered." }, { "value": "THRESHOLD_POSTPAID", "description": "Charge payer when the set amount is reached or monthly billing cycle, whichever comes first, after the goods/service is delivered." }, { "value": "SUBSCRIPTION_PREPAID", "description": "Subscription plan where the \"amount due\" and the \"billing frequency\" are fixed, and there is no defined duration with the payment due before the good/service is delivered." }, { "value": "SUBSCRIPTION_POSTPAID", "description": "Subscription plan where the \"amount due\" and the \"billing frequency\" are fixed, and there is no defined duration with the payment due after the goods/services are delivered." }, { "value": "UNSCHEDULED_PREPAID", "description": "Unscheduled card on file plan where the merchant can bill buyer upfront based on an agreed logic, but \"amount due\" and \"frequency\" can vary. Inclusive of automatic reload plans." }, { "value": "UNSCHEDULED_POSTPAID", "description": "Unscheduled card on file plan where the merchant can bill buyer based on an agreed logic, but \"amount due\" and \"frequency\" can vary. Inclusive of automatic reload plans." }, { "value": "INSTALLMENT_PREPAID", "description": "Merchant-managed installment plan when the \"amount\" to be paid and the \"billing frequency\" are fixed, but there is a defined number of payments with the payment due before the good/service is delivered." }, { "value": "INSTALLMENT_POSTPAID", "description": "Merchant-managed installment plan when the \"amount\" to be paid and the \"billing frequency\" are fixed, but there is a defined number of payments with the payment due after the goods/services are delivered." } ], "enum": [ "IMMEDIATE", "DEFERRED", "RECURRING_PREPAID", "RECURRING_POSTPAID", "THRESHOLD_PREPAID", "THRESHOLD_POSTPAID", "SUBSCRIPTION_PREPAID", "SUBSCRIPTION_POSTPAID", "UNSCHEDULED_PREPAID", "UNSCHEDULED_POSTPAID", "INSTALLMENT_PREPAID", "INSTALLMENT_POSTPAID" ] }, "usage_type": { "title": "PayPal Payment Token Usage Type", "type": "string", "description": "The usage type associated with the PayPal payment token.", "minLength": 1, "maxLength": 255, "pattern": "^[0-9A-Z_]+$", "x-enumDescriptions": [ { "value": "MERCHANT", "description": "The PayPal Payment Token will be used for future transaction directly with a merchant." }, { "value": "PLATFORM", "description": "The PayPal Payment Token will be used for future transaction on a platform. A platform is typically a marketplace or a channel that a payer can purchase goods and services from multiple merchants." } ], "enum": ["MERCHANT", "PLATFORM"] }, "customer_type": { "title": "PayPal Payment Token Customer Type", "type": "string", "description": "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.", "minLength": 1, "maxLength": 255, "pattern": "^[0-9A-Z_]+$", "default": "CONSUMER", "x-enumDescriptions": [ { "value": "CONSUMER", "description": "The customer vaulting the PayPal payment token is a consumer on the merchant / platform." }, { "value": "BUSINESS", "description": "The customer vaulting the PayPal payment token is a business on merchant / platform." } ], "enum": ["CONSUMER", "BUSINESS"] }, "permit_multiple_payment_tokens": { "type": "boolean", "description": "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.", "default": false } } }, { "type": "object", "title": "Vaulted PayPal Wallet Common Attributes", "description": "Resource consolidating common request and response attributes for vaulting PayPal Wallet.", "required": ["usage_type"] }, { "description": "Attributes used to provide the instructions during vaulting of the PayPal Wallet." } ] } } }, "paypal_wallet_attributes_response": { "type": "object", "title": "PayPal Wallet Attributes Response", "description": "Additional attributes associated with the use of a PayPal Wallet.", "properties": { "vault": { "$ref": "#/components/schemas/paypal_wallet_vault_response" }, "cobranded_cards": { "$ref": "#/components/schemas/cobranded_card_list" } } }, "paypal_wallet_customer": { "type": "object", "title": "PayPal Wallet Customer Information", "description": "The details about a customer in PayPal's system of record.", "allOf": [ { "$ref": "#/components/schemas/customer" }, { "properties": { "merchant_customer_id": { "description": "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.", "type": "string", "minLength": 1, "maxLength": 64, "pattern": "^[0-9a-zA-Z-_.^*$@#]+$" } } } ] }, "paypal_wallet_experience_context": { "type": "object", "title": "PayPal Wallet Experience Context", "description": "Customizes the payer experience during the approval process for payment with PayPal.
Note: Partners and Marketplaces might configure brand_name and shipping_preference during partner account setup, which overrides the request values.
", "properties": { "brand_name": { "type": "string", "description": "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.", "minLength": 1, "maxLength": 127, "pattern": "^.*$" }, "locale": { "description": "The BCP 47-formatted locale of pages that the PayPal payment experience shows. PayPal supports a five-character code. For example, `da-DK`, `he-IL`, `id-ID`, `ja-JP`, `no-NO`, `pt-BR`, `ru-RU`, `sv-SE`, `th-TH`, `zh-CN`, `zh-HK`, or `zh-TW`.", "$ref": "#/components/schemas/language" }, "shipping_preference": { "type": "string", "description": "The location from which the shipping address is derived.", "minLength": 1, "maxLength": 24, "pattern": "^[A-Z_]+$", "default": "GET_FROM_FILE", "x-enumDescriptions": [ { "value": "GET_FROM_FILE", "description": "Get the customer-provided shipping address on the PayPal site." }, { "value": "NO_SHIPPING", "description": "Removes the shipping address information from the API response and the Paypal site. However, the shipping.phone_number and shipping.email_address fields will still be returned to allow for digital goods delivery." }, { "value": "SET_PROVIDED_ADDRESS", "description": "Get the merchant-provided address. The customer cannot change this address on the PayPal site. If merchant does not pass an address, customer can choose the address on PayPal pages." } ], "enum": ["GET_FROM_FILE", "NO_SHIPPING", "SET_PROVIDED_ADDRESS"] }, "contact_preference": { "type": "string", "description": "The preference to display the contact information (buyer’s shipping email & phone number) on PayPal's checkout for easy merchant-buyer communication.", "minLength": 1, "maxLength": 24, "pattern": "^[A-Z_]+$", "default": "NO_CONTACT_INFO", "x-enumDescriptions": [ { "value": "NO_CONTACT_INFO", "description": "The merchant can opt out of showing buyer's contact information on PayPal checkout." }, { "value": "UPDATE_CONTACT_INFO", "description": "The merchant allows buyer to add or update shipping contact information on the PayPal checkout. Please ensure to use this updated information returned in shipping.email_address and shipping.phone_number to contact your buyers." }, { "value": "RETAIN_CONTACT_INFO", "description": "The buyer can only see but can not override merchant passed contact information (shipping.email_address and shipping.phone_number) on PayPal checkout. NOTE: If you don't pass the contact information, the behavior is the same as NO_CONTACT_INFO preference." } ], "enum": [ "NO_CONTACT_INFO", "UPDATE_CONTACT_INFO", "RETAIN_CONTACT_INFO" ] }, "return_url": { "description": "The URL where the customer will be redirected upon approving a payment.", "format": "uri", "$ref": "#/components/schemas/url" }, "cancel_url": { "description": "The URL where the customer will be redirected upon cancelling the payment approval.", "format": "uri", "$ref": "#/components/schemas/url" }, "landing_page": { "type": "string", "description": "The type of landing page to show on the PayPal site for customer checkout.", "default": "NO_PREFERENCE", "x-enumDescriptions": [ { "value": "LOGIN", "description": "When the customer clicks PayPal Checkout, the customer is redirected to a page to log in to PayPal and approve the payment." }, { "value": "GUEST_CHECKOUT", "description": "When the customer clicks PayPal Checkout, the customer is redirected to a page to enter credit or debit card and other relevant billing information required to complete the purchase. This option has previously been also called as 'BILLING'" }, { "value": "NO_PREFERENCE", "description": "When the customer clicks PayPal Checkout, the customer is redirected to either a page to log in to PayPal and approve the payment or to a page to enter credit or debit card and other relevant billing information required to complete the purchase, depending on their previous interaction with PayPal." } ], "minLength": 1, "maxLength": 13, "pattern": "^[0-9A-Z_]+$", "enum": ["LOGIN", "GUEST_CHECKOUT", "NO_PREFERENCE"] }, "user_action": { "type": "string", "description": "Configures a Continue or Pay Now checkout flow.", "default": "CONTINUE", "x-enumDescriptions": [ { "value": "CONTINUE", "description": "After you redirect the customer to the PayPal payment page, a Continue button appears. Use this option when the final amount is not known when the checkout flow is initiated and you want to redirect the customer to the merchant page without processing the payment.", "default": true }, { "value": "PAY_NOW", "description": "After you redirect the customer to the PayPal payment page, a Pay Now button appears. Use this option when the final amount is known when the checkout is initiated and you want to process the payment immediately when the customer clicks Pay Now." } ], "minLength": 1, "maxLength": 8, "pattern": "^[0-9A-Z_]+$", "enum": ["CONTINUE", "PAY_NOW"] }, "payment_method_preference": { "type": "string", "description": "The merchant-preferred payment methods.", "minLength": 1, "maxLength": 255, "pattern": "^[0-9A-Z_]+$", "default": "UNRESTRICTED", "x-enumDescriptions": [ { "value": "UNRESTRICTED", "description": "Accepts any type of payment from the customer.", "default": true }, { "value": "IMMEDIATE_PAYMENT_REQUIRED", "description": "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 `pending` status." } ], "enum": ["UNRESTRICTED", "IMMEDIATE_PAYMENT_REQUIRED"] }, "order_update_callback_config": { "description": "Merchant provided Order Update callback configuration for PayPal Wallet.PayPal will call back merchant when the specified event occurs.we recommend merchants to pass both the shipping_options and shipping_address callback events. Not supported when `shipping.type` is specified or when 'application_context.shipping_preference' is set as 'NO_SHIPPING' or 'SET_PROVIDED_ADDRESS'.", "$ref": "#/components/schemas/callback_configuration" } } }, "paypal_wallet_response": { "type": "object", "title": "PayPal Wallet Response", "description": "The PayPal Wallet response.", "properties": { "email_address": { "description": "The email address of the PayPal account holder.", "$ref": "#/components/schemas/email" }, "account_id": { "description": "The PayPal-assigned ID for the PayPal account holder.", "readOnly": true, "$ref": "#/components/schemas/account_id-2" }, "account_status": { "type": "string", "description": "The account status indicates whether the buyer has verified the financial details associated with their PayPal account.", "readOnly": true, "minLength": 1, "maxLength": 255, "pattern": "^[A-Z_]+$", "x-enumDescriptions": [ { "value": "VERIFIED", "description": "The buyer has completed the verification of the financial details associated with this PayPal account. For example: confirming their bank account." }, { "value": "UNVERIFIED", "description": "The buyer has not completed the verification of the financial details associated with this PayPal account. For example: confirming their bank account." } ], "enum": ["VERIFIED", "UNVERIFIED"] }, "name": { "description": "The name of the party.", "type": "object", "title": "Name", "properties": { "given_name": { "type": "string", "description": "When the party is a person, the party's given, or first, name.", "maxLength": 140 }, "surname": { "type": "string", "description": "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.", "maxLength": 140 } } }, "phone_type": { "$ref": "#/components/schemas/phone_type" }, "phone_number": { "description": "The phone number, in its canonical international [E.164 numbering plan format](https://www.itu.int/rec/T-REC-E.164/en). Available only when you enable the **Contact Telephone Number** option in the **Profile & Settings** for the merchant's PayPal account. Supports only the `national_number` property.", "$ref": "#/components/schemas/phone" }, "birth_date": { "description": "The birth date of the PayPal account holder in `YYYY-MM-DD` format.", "$ref": "#/components/schemas/date_no_time" }, "business_name": { "description": "The business name of the PayPal account holder (populated for business accounts only)", "type": "string", "minLength": 0, "maxLength": 300, "pattern": "^.*$" }, "tax_info": { "description": "The tax information of the PayPal account holder. Required only for Brazilian PayPal account holder's. Both `tax_id` and `tax_id_type` are required.", "$ref": "#/components/schemas/tax_info" }, "address": { "description": "The portable international postal address. Maps to [AddressValidationMetadata](https://github.com/googlei18n/libaddressinput/wiki/AddressValidationMetadata) and HTML 5.1 [Autofilling form controls: the autocomplete attribute](https://www.w3.org/TR/html51/sec-forms.html#autofilling-form-controls-the-autocomplete-attribute).", "type": "object", "title": "Portable Postal Address (Medium-Grained)", "properties": { "address_line_1": { "type": "string", "description": "The first line of the address, such as number and street, for example, `173 Drury Lane`. Needed for data entry, and Compliance and Risk checks. This field needs to pass the full address.", "maxLength": 300 }, "address_line_2": { "type": "string", "description": "The second line of the address, for example, a suite or apartment number.", "maxLength": 300 }, "admin_area_2": { "type": "string", "description": "A city, town, or village. Smaller than `admin_area_level_1`.", "maxLength": 120 }, "admin_area_1": { "type": "string", "description": "The highest-level sub-division in a country, which is usually a province, state, or ISO-3166-2 subdivision. This data is formatted for postal delivery, for example, `CA` and not `California`. Value, by country, is:", "maxLength": 300 }, "postal_code": { "type": "string", "description": "The postal code, which is the ZIP code or equivalent. Typically required for countries with a postal code or an equivalent. See [postal code](https://en.wikipedia.org/wiki/Postal_code).", "maxLength": 60 }, "country_code": { "$ref": "#/components/schemas/country_code" } }, "required": ["country_code"] }, "attributes": { "$ref": "#/components/schemas/paypal_wallet_attributes_response" }, "stored_credential": { "$ref": "#/components/schemas/paypal_wallet_stored_credential" } } }, "paypal_wallet_stored_credential": { "type": "object", "title": "PayPal Wallet stored credentials", "description": "Provides additional details to process a payment using the PayPal wallet billing agreement or a vaulted payment method that has been stored or is intended to be stored.", "properties": { "payment_initiator": { "$ref": "#/components/schemas/payment_initiator" }, "charge_pattern": { "description": "DEPRECATED. Expected business/pricing model for the billing agreement, Please use usage_pattern instead.", "$ref": "#/components/schemas/charge_pattern", "deprecated": true }, "usage_pattern": { "$ref": "#/components/schemas/charge_pattern" }, "usage": { "$ref": "#/components/schemas/stored_payment_source_usage_type" } }, "required": ["payment_initiator"] }, "paypal_wallet_vault_response": { "type": "object", "title": "PayPal Wallet Vault Response", "description": "The details about a saved PayPal Wallet payment source.", "properties": { "id": { "type": "string", "description": "The PayPal-generated ID for the saved payment source.", "minLength": 1, "maxLength": 255 }, "status": { "title": "Vault Status", "type": "string", "description": "The vault status.", "minLength": 1, "maxLength": 255, "pattern": "^[0-9A-Z_]+$", "x-enumDescriptions": [ { "value": "VAULTED", "description": "The payment source has been saved in your customer's vault. This vault status reflects `/v3/vault` status." }, { "value": "CREATED", "description": "DEPRECATED. The payment source has been saved in your customer's vault. This status applies to deprecated integration patterns and will not be returned for v3/vault integrations." }, { "value": "APPROVED", "description": "Customer has approved the action of saving the specified payment_source into their vault. Use v3/vault/payment-tokens with given setup_token to save the payment source in the vault" } ], "deprecated": true, "enum": ["VAULTED", "CREATED", "APPROVED"] }, "links": { "$ref": "#/components/schemas/link_description_list" }, "customer": { "$ref": "#/components/schemas/paypal_wallet_customer" } } }, "phone": { "type": "object", "title": "Phone Number", "description": "The phone number in its canonical international [E.164 numbering plan format](https://www.itu.int/rec/T-REC-E.164/en).", "properties": { "national_number": { "type": "string", "description": "The national number, in its canonical international [E.164 numbering plan format](https://www.itu.int/rec/T-REC-E.164/en). 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).", "minLength": 1, "maxLength": 14, "pattern": "^[0-9]{1,14}?$" } }, "required": ["national_number"] }, "phone_type": { "type": "string", "title": "Phone Type", "description": "The phone type.", "enum": ["FAX", "HOME", "MOBILE", "OTHER", "PAGER"], "x-enumDescriptions": { "FAX": "Fax number.", "HOME": "Home phone number.", "MOBILE": "Mobile phone number.", "OTHER": "Other phone number.", "PAGER": "Pager number." } }, "phone_with_type": { "type": "object", "title": "Phone With Type", "description": "The phone information.", "properties": { "phone_type": { "$ref": "#/components/schemas/phone_type" }, "phone_number": { "description": "The phone number, in its canonical international [E.164 numbering plan format](https://www.itu.int/rec/T-REC-E.164/en).", "type": "object", "title": "Phone", "properties": { "national_number": { "type": "string", "description": "The national number, in its canonical international [E.164 numbering plan format](https://www.itu.int/rec/T-REC-E.164/en). 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).", "minLength": 1, "maxLength": 14, "pattern": "^[0-9]{1,14}?$" } }, "required": ["national_number"] } }, "required": ["phone_number"] }, "pix": { "type": "object", "title": "Pix payment object", "description": "Information needed to pay using Pix.", "properties": { "country_code": { "description": "The two-character ISO 3166-1 purchase country code.", "$ref": "#/components/schemas/country_code" }, "name": { "description": "The name of the account holder associated with PIX.", "$ref": "#/components/schemas/full_name" }, "email_address": { "description": "The email address of the account holder associated with Pix.", "$ref": "#/components/schemas/email_address" }, "phone_number": { "description": "The phone number in its canonical international [E.164 numbering plan format](https://www.itu.int/rec/T-REC-E.164/en).", "type": "object", "title": "Phone", "properties": { "country_code": { "type": "string", "description": "The country calling code (CC), in its canonical international [E.164 numbering plan format](https://www.itu.int/rec/T-REC-E.164/en). 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).", "minLength": 1, "maxLength": 3, "pattern": "^[0-9]{1,3}?$" }, "national_number": { "type": "string", "description": "The national number, in its canonical international [E.164 numbering plan format](https://www.itu.int/rec/T-REC-E.164/en). 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).", "minLength": 1, "maxLength": 14, "pattern": "^[0-9]{1,14}?$" } }, "required": ["country_code", "national_number"] }, "tax_info": { "description": "The tax information of the account holder.", "$ref": "#/components/schemas/tax_info" }, "currency_code": { "$ref": "#/components/schemas/currency_code-2" }, "qr_details": { "$ref": "#/components/schemas/qr_details" } } }, "pix_request": { "type": "object", "title": "Pix payment object", "description": "Information needed to pay using Pix.", "properties": { "country_code": { "description": "The two-character ISO 3166-1 purchase country code.", "$ref": "#/components/schemas/country_code" }, "name": { "description": "The name of the account holder associated with PIX.", "$ref": "#/components/schemas/full_name" }, "email_address": { "description": "The email address of the account holder associated with Pix.", "$ref": "#/components/schemas/email_address" }, "phone_number": { "description": "The phone number in its canonical international [E.164 numbering plan format](https://www.itu.int/rec/T-REC-E.164/en).", "type": "object", "title": "Phone", "properties": { "country_code": { "type": "string", "description": "The country calling code (CC), in its canonical international [E.164 numbering plan format](https://www.itu.int/rec/T-REC-E.164/en). 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).", "minLength": 1, "maxLength": 3, "pattern": "^[0-9]{1,3}?$" }, "national_number": { "type": "string", "description": "The national number, in its canonical international [E.164 numbering plan format](https://www.itu.int/rec/T-REC-E.164/en). 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).", "minLength": 1, "maxLength": 14, "pattern": "^[0-9]{1,14}?$" } }, "required": ["country_code", "national_number"] }, "tax_info": { "description": "The tax information of the account holder.", "$ref": "#/components/schemas/tax_info" }, "currency_code": { "$ref": "#/components/schemas/currency_code-2" }, "qr_details": { "$ref": "#/components/schemas/qr_details" } }, "required": [ "country_code", "name", "email_address", "phone_number", "tax_info", "currency_code" ] }, "platform_fee": { "type": "object", "title": "Platform Fee", "description": "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.", "properties": { "amount": { "description": "The fee for this transaction.", "$ref": "#/components/schemas/money" }, "payee": { "description": "The recipient of the fee for this transaction. If you omit this value, the default is the API caller.", "$ref": "#/components/schemas/payee_base" } }, "required": ["amount"] }, "platform_fee_list": { "type": "array", "description": "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.", "minItems": 0, "maxItems": 1, "items": { "$ref": "#/components/schemas/platform_fee" } }, "pricing_scheme": { "title": "Pricing Scheme", "description": "The pricing scheme details.", "type": "object", "properties": { "price": { "description": "The price the customer will be charged based on the pricing model", "$ref": "#/components/schemas/money" }, "pricing_model": { "type": "string", "description": "The pricing model for the billing cycle.", "minLength": 1, "maxLength": 24, "pattern": "^[A-Z_]+$", "x-enumDescriptions": [ { "value": "FIXED", "description": "A fixed pricing scheme where the customer is charged a fixed amount." }, { "value": "VARIABLE", "description": "A variable pricing scheme where the customer is charged a variable amount." }, { "value": "AUTO_RELOAD", "description": "A auto-reload pricing scheme where the customer is charged a fixed amount for reload." } ], "enum": ["FIXED", "VARIABLE", "AUTO_RELOAD"] }, "reload_threshold_amount": { "description": "The threshold amount on which the reload charge would be triggered. This will be associated with the account-balance where if the account-balance goes below this amount then customer would incur reload charge.", "$ref": "#/components/schemas/money" } }, "required": ["pricing_model"] }, "processing_instruction": {}, "processor_response": { "type": "object", "title": "Processor Response", "description": "The processor response information for payment requests, such as direct credit card transactions.", "properties": { "avs_code": { "description": "The address verification code for Visa, Discover, Mastercard, or American Express transactions.", "type": "string", "readOnly": true, "x-enumDescriptions": [ { "value": "A", "description": "For Visa, Mastercard, or Discover transactions, the address matches but the zip code does not match. For American Express transactions, the card holder address is correct." }, { "value": "B", "description": "For Visa, Mastercard, or Discover transactions, the address matches. International A." }, { "value": "C", "description": "For Visa, Mastercard, or Discover transactions, no values match. International N." }, { "value": "D", "description": "For Visa, Mastercard, or Discover transactions, the address and postal code match. International X." }, { "value": "E", "description": "For Visa, Mastercard, or Discover transactions, not allowed for Internet or phone transactions. For American Express card holder, the name is incorrect but the address and postal code match." }, { "value": "F", "description": "For Visa, Mastercard, or Discover transactions, the address and postal code match. UK-specific X. For American Express card holder, the name is incorrect but the address matches." }, { "value": "G", "description": "For Visa, Mastercard, or Discover transactions, global is unavailable. Nothing matches." }, { "value": "I", "description": "For Visa, Mastercard, or Discover transactions, international is unavailable. Not applicable." }, { "value": "M", "description": "For Visa, Mastercard, or Discover transactions, the address and postal code match. For American Express card holder, the name, address, and postal code match." }, { "value": "N", "description": "For Visa, Mastercard, or Discover transactions, nothing matches. For American Express card holder, the address and postal code are both incorrect." }, { "value": "P", "description": "For Visa, Mastercard, or Discover transactions, postal international Z. Postal code only." }, { "value": "R", "description": "For Visa, Mastercard, or Discover transactions, re-try the request. For American Express, the system is unavailable." }, { "value": "S", "description": "For Visa, Mastercard, Discover, or American Express, the service is not supported." }, { "value": "U", "description": "For Visa, Mastercard, or Discover transactions, the service is unavailable. For American Express, information is not available. For Maestro, the address is not checked or the acquirer had no response. The service is not available." }, { "value": "W", "description": "For Visa, Mastercard, or Discover transactions, whole ZIP code. For American Express, the card holder name, address, and postal code are all incorrect." }, { "value": "X", "description": "For Visa, Mastercard, or Discover transactions, exact match of the address and the nine-digit ZIP code. For American Express, the card holder name, address, and postal code are all incorrect." }, { "value": "Y", "description": "For Visa, Mastercard, or Discover transactions, the address and five-digit ZIP code match. For American Express, the card holder address and postal code are both correct." }, { "value": "Z", "description": "For Visa, Mastercard, or Discover transactions, the five-digit ZIP code matches but no address. For American Express, only the card holder postal code is correct." }, { "value": "Null", "description": "For Maestro, no AVS response was obtained." }, { "value": "0", "description": "For Maestro, all address information matches." }, { "value": "1", "description": "For Maestro, none of the address information matches." }, { "value": "2", "description": "For Maestro, part of the address information matches." }, { "value": "3", "description": "For Maestro, the merchant did not provide AVS information. It was not processed." }, { "value": "4", "description": "For Maestro, the address was not checked or the acquirer had no response. The service is not available." } ], "enum": [ "A", "B", "C", "D", "E", "F", "G", "I", "M", "N", "P", "R", "S", "U", "W", "X", "Y", "Z", "Null", "0", "1", "2", "3", "4" ] }, "cvv_code": { "description": "The card verification value code for for Visa, Discover, Mastercard, or American Express.", "type": "string", "readOnly": true, "x-enumDescriptions": [ { "value": "E", "description": "For Visa, Mastercard, Discover, or American Express, error - unrecognized or unknown response." }, { "value": "I", "description": "For Visa, Mastercard, Discover, or American Express, invalid or null." }, { "value": "M", "description": "For Visa, Mastercard, Discover, or American Express, the CVV2/CSC matches." }, { "value": "N", "description": "For Visa, Mastercard, Discover, or American Express, the CVV2/CSC does not match." }, { "value": "P", "description": "For Visa, Mastercard, Discover, or American Express, it was not processed." }, { "value": "S", "description": "For Visa, Mastercard, Discover, or American Express, the service is not supported." }, { "value": "U", "description": "For Visa, Mastercard, Discover, or American Express, unknown - the issuer is not certified." }, { "value": "X", "description": "For Visa, Mastercard, Discover, or American Express, no response. For Maestro, the service is not available." }, { "value": "All others", "description": "For Visa, Mastercard, Discover, or American Express, error." }, { "value": "0", "description": "For Maestro, the CVV2 matched." }, { "value": "1", "description": "For Maestro, the CVV2 did not match." }, { "value": "2", "description": "For Maestro, the merchant has not implemented CVV2 code handling." }, { "value": "3", "description": "For Maestro, the merchant has indicated that CVV2 is not present on card." }, { "value": "4", "description": "For Maestro, the service is not available." } ], "enum": [ "E", "I", "M", "N", "P", "S", "U", "X", "All others", "0", "1", "2", "3", "4" ] }, "response_code": { "description": "Processor response code for the non-PayPal payment processor errors.", "type": "string", "readOnly": true, "x-enumDescriptions": [ { "value": "0000", "description": "APPROVED." }, { "value": "00N7", "description": "CVV2_FAILURE_POSSIBLE_RETRY_WITH_CVV." }, { "value": "0100", "description": "REFERRAL." }, { "value": "0390", "description": "ACCOUNT_NOT_FOUND." }, { "value": "0500", "description": "DO_NOT_HONOR." }, { "value": "0580", "description": "UNAUTHORIZED_TRANSACTION." }, { "value": "0800", "description": "BAD_RESPONSE_REVERSAL_REQUIRED." }, { "value": "0880", "description": "CRYPTOGRAPHIC_FAILURE." }, { "value": "0890", "description": "UNACCEPTABLE_PIN." }, { "value": "0960", "description": "SYSTEM_MALFUNCTION." }, { "value": "0R00", "description": "CANCELLED_PAYMENT." }, { "value": "1000", "description": "PARTIAL_AUTHORIZATION." }, { "value": "10BR", "description": "ISSUER_REJECTED." }, { "value": "1300", "description": "INVALID_DATA_FORMAT." }, { "value": "1310", "description": "INVALID_AMOUNT." }, { "value": "1312", "description": "INVALID_TRANSACTION_CARD_ISSUER_ACQUIRER." }, { "value": "1317", "description": "INVALID_CAPTURE_DATE." }, { "value": "1320", "description": "INVALID_CURRENCY_CODE." }, { "value": "1330", "description": "INVALID_ACCOUNT." }, { "value": "1335", "description": "INVALID_ACCOUNT_RECURRING." }, { "value": "1340", "description": "INVALID_TERMINAL." }, { "value": "1350", "description": "INVALID_MERCHANT." }, { "value": "1352", "description": "RESTRICTED_OR_INACTIVE_ACCOUNT." }, { "value": "1360", "description": "BAD_PROCESSING_CODE." }, { "value": "1370", "description": "INVALID_MCC." }, { "value": "1380", "description": "INVALID_EXPIRATION." }, { "value": "1382", "description": "INVALID_CARD_VERIFICATION_VALUE." }, { "value": "1384", "description": "INVALID_LIFE_CYCLE_OF_TRANSACTION." }, { "value": "1390", "description": "INVALID_ORDER." }, { "value": "1393", "description": "TRANSACTION_CANNOT_BE_COMPLETED." }, { "value": "5100", "description": "GENERIC_DECLINE." }, { "value": "5110", "description": "CVV2_FAILURE." }, { "value": "5120", "description": "INSUFFICIENT_FUNDS." }, { "value": "5130", "description": "INVALID_PIN." }, { "value": "5135", "description": "DECLINED_PIN_TRY_EXCEEDED." }, { "value": "5140", "description": "CARD_CLOSED." }, { "value": "5150", "description": "PICKUP_CARD_SPECIAL_CONDITIONS. Try using another card. Do not retry the same card." }, { "value": "5160", "description": "UNAUTHORIZED_USER." }, { "value": "5170", "description": "AVS_FAILURE." }, { "value": "5180", "description": "INVALID_OR_RESTRICTED_CARD. Try using another card. Do not retry the same card." }, { "value": "5190", "description": "SOFT_AVS." }, { "value": "5200", "description": "DUPLICATE_TRANSACTION." }, { "value": "5210", "description": "INVALID_TRANSACTION." }, { "value": "5400", "description": "EXPIRED_CARD." }, { "value": "5500", "description": "INCORRECT_PIN_REENTER." }, { "value": "5650", "description": "DECLINED_SCA_REQUIRED." }, { "value": "5700", "description": "TRANSACTION_NOT_PERMITTED. Outside of scope of accepted business." }, { "value": "5710", "description": "TX_ATTEMPTS_EXCEED_LIMIT." }, { "value": "5800", "description": "REVERSAL_REJECTED." }, { "value": "5900", "description": "INVALID_ISSUE." }, { "value": "5910", "description": "ISSUER_NOT_AVAILABLE_NOT_RETRIABLE." }, { "value": "5920", "description": "ISSUER_NOT_AVAILABLE_RETRIABLE." }, { "value": "5930", "description": "CARD_NOT_ACTIVATED." }, { "value": "5950", "description": "DECLINED_DUE_TO_UPDATED_ACCOUNT. External decline as an updated card has been issued." }, { "value": "6300", "description": "ACCOUNT_NOT_ON_FILE." }, { "value": "7600", "description": "APPROVED_NON_CAPTURE." }, { "value": "7700", "description": "ERROR_3DS." }, { "value": "7710", "description": "AUTHENTICATION_FAILED." }, { "value": "7800", "description": "BIN_ERROR." }, { "value": "7900", "description": "PIN_ERROR." }, { "value": "8000", "description": "PROCESSOR_SYSTEM_ERROR." }, { "value": "8010", "description": "HOST_KEY_ERROR." }, { "value": "8020", "description": "CONFIGURATION_ERROR." }, { "value": "8030", "description": "UNSUPPORTED_OPERATION." }, { "value": "8100", "description": "FATAL_COMMUNICATION_ERROR." }, { "value": "8110", "description": "RETRIABLE_COMMUNICATION_ERROR." }, { "value": "8220", "description": "SYSTEM_UNAVAILABLE." }, { "value": "9100", "description": "DECLINED_PLEASE_RETRY. Retry." }, { "value": "9500", "description": "SUSPECTED_FRAUD. Try using another card. Do not retry the same card." }, { "value": "9510", "description": "SECURITY_VIOLATION." }, { "value": "9520", "description": "LOST_OR_STOLEN. Try using another card. Do not retry the same card." }, { "value": "9530", "description": "HOLD_CALL_CENTER. The merchant must call the number on the back of the card. POS scenario." }, { "value": "9540", "description": "REFUSED_CARD." }, { "value": "9600", "description": "UNRECOGNIZED_RESPONSE_CODE." }, { "value": "PCNR", "description": "CONTINGENCIES_NOT_RESOLVED." }, { "value": "PCVV", "description": "CVV_FAILURE." }, { "value": "PP06", "description": "ACCOUNT_CLOSED. A previously open account is now closed" }, { "value": "PPRN", "description": "REATTEMPT_NOT_PERMITTED." }, { "value": "PPAD", "description": "BILLING_ADDRESS." }, { "value": "PPAB", "description": "ACCOUNT_BLOCKED_BY_ISSUER." }, { "value": "PPAE", "description": "AMEX_DISABLED." }, { "value": "PPAG", "description": "ADULT_GAMING_UNSUPPORTED." }, { "value": "PPAI", "description": "AMOUNT_INCOMPATIBLE." }, { "value": "PPAR", "description": "AUTH_RESULT." }, { "value": "PPAU", "description": "MCC_CODE." }, { "value": "PPAV", "description": "ARC_AVS." }, { "value": "PPAX", "description": "AMOUNT_EXCEEDED." }, { "value": "PPBG", "description": "BAD_GAMING." }, { "value": "PPC2", "description": "ARC_CVV." }, { "value": "PPCE", "description": "CE_REGISTRATION_INCOMPLETE." }, { "value": "PPCO", "description": "COUNTRY." }, { "value": "PPCR", "description": "CREDIT_ERROR." }, { "value": "PPCT", "description": "CARD_TYPE_UNSUPPORTED." }, { "value": "PPCU", "description": "CURRENCY_USED_INVALID." }, { "value": "PPD3", "description": "SECURE_ERROR_3DS." }, { "value": "PPDC", "description": "DCC_UNSUPPORTED." }, { "value": "PPDI", "description": "DINERS_REJECT." }, { "value": "PPDV", "description": "AUTH_MESSAGE." }, { "value": "PPDT", "description": "DECLINE_THRESHOLD_BREACH." }, { "value": "PPEF", "description": "EXPIRED_FUNDING_INSTRUMENT." }, { "value": "PPEL", "description": "EXCEEDS_FREQUENCY_LIMIT." }, { "value": "PPER", "description": "INTERNAL_SYSTEM_ERROR." }, { "value": "PPEX", "description": "EXPIRY_DATE." }, { "value": "PPFE", "description": "FUNDING_SOURCE_ALREADY_EXISTS." }, { "value": "PPFI", "description": "INVALID_FUNDING_INSTRUMENT." }, { "value": "PPFR", "description": "RESTRICTED_FUNDING_INSTRUMENT." }, { "value": "PPFV", "description": "FIELD_VALIDATION_FAILED." }, { "value": "PPGR", "description": "GAMING_REFUND_ERROR." }, { "value": "PPH1", "description": "H1_ERROR." }, { "value": "PPIF", "description": "IDEMPOTENCY_FAILURE." }, { "value": "PPII", "description": "INVALID_INPUT_FAILURE." }, { "value": "PPIM", "description": "ID_MISMATCH." }, { "value": "PPIT", "description": "INVALID_TRACE_ID." }, { "value": "PPLR", "description": "LATE_REVERSAL." }, { "value": "PPLS", "description": "LARGE_STATUS_CODE." }, { "value": "PPMB", "description": "MISSING_BUSINESS_RULE_OR_DATA." }, { "value": "PPMC", "description": "BLOCKED_Mastercard." }, { "value": "PPMD", "description": "DEPRECATED The PPMD value has been deprecated." }, { "value": "PPNC", "description": "NOT_SUPPORTED_NRC." }, { "value": "PPNL", "description": "EXCEEDS_NETWORK_FREQUENCY_LIMIT." }, { "value": "PPNM", "description": "NO_MID_FOUND." }, { "value": "PPNT", "description": "NETWORK_ERROR." }, { "value": "PPPH", "description": "NO_PHONE_FOR_DCC_TRANSACTION." }, { "value": "PPPI", "description": "INVALID_PRODUCT." }, { "value": "PPPM", "description": "INVALID_PAYMENT_METHOD." }, { "value": "PPQC", "description": "QUASI_CASH_UNSUPPORTED." }, { "value": "PPRE", "description": "UNSUPPORT_REFUND_ON_PENDING_BC." }, { "value": "PPRF", "description": "INVALID_PARENT_TRANSACTION_STATUS." }, { "value": "PPRR", "description": "MERCHANT_NOT_REGISTERED." }, { "value": "PPS0", "description": "BANKAUTH_ROW_MISMATCH." }, { "value": "PPS1", "description": "BANKAUTH_ROW_SETTLED." }, { "value": "PPS2", "description": "BANKAUTH_ROW_VOIDED." }, { "value": "PPS3", "description": "BANKAUTH_EXPIRED." }, { "value": "PPS4", "description": "CURRENCY_MISMATCH." }, { "value": "PPS5", "description": "CREDITCARD_MISMATCH." }, { "value": "PPS6", "description": "AMOUNT_MISMATCH." }, { "value": "PPSC", "description": "ARC_SCORE." }, { "value": "PPSD", "description": "STATUS_DESCRIPTION." }, { "value": "PPSE", "description": "AMEX_DENIED." }, { "value": "PPTE", "description": "VERIFICATION_TOKEN_EXPIRED." }, { "value": "PPTF", "description": "INVALID_TRACE_REFERENCE." }, { "value": "PPTI", "description": "INVALID_TRANSACTION_ID." }, { "value": "PPTR", "description": "VERIFICATION_TOKEN_REVOKED." }, { "value": "PPTT", "description": "TRANSACTION_TYPE_UNSUPPORTED." }, { "value": "PPTV", "description": "INVALID_VERIFICATION_TOKEN." }, { "value": "PPUA", "description": "USER_NOT_AUTHORIZED." }, { "value": "PPUC", "description": "CURRENCY_CODE_UNSUPPORTED." }, { "value": "PPUE", "description": "UNSUPPORT_ENTITY." }, { "value": "PPUI", "description": "UNSUPPORT_INSTALLMENT." }, { "value": "PPUP", "description": "UNSUPPORT_POS_FLAG." }, { "value": "PPUR", "description": "UNSUPPORTED_REVERSAL." }, { "value": "PPVC", "description": "VALIDATE_CURRENCY." }, { "value": "PPVE", "description": "VALIDATION_ERROR." }, { "value": "PPVT", "description": "VIRTUAL_TERMINAL_UNSUPPORTED." } ], "enum": [ "0000", "00N7", "0100", "0390", "0500", "0580", "0800", "0880", "0890", "0960", "0R00", "1000", "10BR", "1300", "1310", "1312", "1317", "1320", "1330", "1335", "1340", "1350", "1352", "1360", "1370", "1380", "1382", "1384", "1390", "1393", "5100", "5110", "5120", "5130", "5135", "5140", "5150", "5160", "5170", "5180", "5190", "5200", "5210", "5400", "5500", "5650", "5700", "5710", "5800", "5900", "5910", "5920", "5930", "5950", "6300", "7600", "7700", "7710", "7800", "7900", "8000", "8010", "8020", "8030", "8100", "8110", "8220", "9100", "9500", "9510", "9520", "9530", "9540", "9600", "PCNR", "PCVV", "PP06", "PPRN", "PPAD", "PPAB", "PPAE", "PPAG", "PPAI", "PPAR", "PPAU", "PPAV", "PPAX", "PPBG", "PPC2", "PPCE", "PPCO", "PPCR", "PPCT", "PPCU", "PPD3", "PPDC", "PPDI", "PPDV", "PPDT", "PPEF", "PPEL", "PPER", "PPEX", "PPFE", "PPFI", "PPFR", "PPFV", "PPGR", "PPH1", "PPIF", "PPII", "PPIM", "PPIT", "PPLR", "PPLS", "PPMB", "PPMC", "PPMD", "PPNC", "PPNL", "PPNM", "PPNT", "PPPH", "PPPI", "PPPM", "PPQC", "PPRE", "PPRF", "PPRR", "PPS0", "PPS1", "PPS2", "PPS3", "PPS4", "PPS5", "PPS6", "PPSC", "PPSD", "PPSE", "PPTE", "PPTF", "PPTI", "PPTR", "PPTT", "PPTV", "PPUA", "PPUC", "PPUE", "PPUI", "PPUP", "PPUR", "PPVC", "PPVE", "PPVT" ] }, "payment_advice_code": { "description": "The declined payment transactions might have payment advice codes. The card networks, like Visa and Mastercard, return payment advice codes.", "type": "string", "readOnly": true, "x-enumDescriptions": [ { "value": "01", "description": "For Mastercard, expired card account upgrade or portfolio sale conversion. Obtain new account information before next billing cycle." }, { "value": "02", "description": "For Mastercard, over credit limit or insufficient funds. Retry the transaction 72 hours later. For Visa, the card holder wants to stop only one specific payment in the recurring payment relationship. The merchant must NOT resubmit the same transaction. The merchant can continue the billing process in the subsequent billing period." }, { "value": "03", "description": "For Mastercard, account closed as fraudulent. Obtain another type of payment from customer due to account being closed or fraud. Possible reason: Account closed as fraudulent. For Visa, the card holder wants to stop all recurring payment transactions for a specific merchant. Stop recurring payment requests." }, { "value": "04", "description": "For Mastercard, token requirements not fulfilled for this token type." }, { "value": "21", "description": "For Mastercard, the card holder has been unsuccessful at canceling recurring payment through merchant. Stop recurring payment requests. For Visa, all recurring payments were canceled for the card number requested. Stop recurring payment requests." }, { "value": "22", "description": "For Mastercard, merchant does not qualify for product code." }, { "value": "24", "description": "For Mastercard, retry after 1 hour." }, { "value": "25", "description": "For Mastercard, retry after 24 hours." }, { "value": "26", "description": "For Mastercard, retry after 2 days." }, { "value": "27", "description": "For Mastercard, retry after 4 days." }, { "value": "28", "description": "For Mastercard, retry after 6 days." }, { "value": "29", "description": "For Mastercard, retry after 8 days." }, { "value": "30", "description": "For Mastercard, retry after 10 days ." }, { "value": "40", "description": "For Mastercard, consumer non-reloadable prepaid card." }, { "value": "43", "description": "For Mastercard, consumer multi-use virtual card number." } ], "enum": [ "01", "02", "03", "04", "21", "22", "24", "25", "26", "27", "28", "29", "30", "40", "43" ] } } }, "products": { "type": "string", "description": "This value provides the category of the BIN.", "minLength": 1, "maxLength": 255 }, "products_list": { "type": "array", "description": "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.", "items": { "$ref": "#/components/schemas/products" }, "minItems": 1, "maxItems": 256 }, "purchase_unit": { "type": "object", "title": "Purchase Unit", "description": "The purchase unit details. Used to capture required information for the payment contract.", "properties": { "reference_id": { "type": "string", "description": "The API caller-provided external ID for the purchase unit. Required for multiple purchase units when you must update the order through `PATCH`. If you omit this value and the order contains only one purchase unit, PayPal sets this value to `default`.
Note: If there are multiple purchase units, reference_id is required for each purchase unit.
", "minLength": 1, "maxLength": 256 }, "amount": { "$ref": "#/components/schemas/amount_with_breakdown" }, "payee": { "description": "The merchant who receives payment for this transaction.", "$ref": "#/components/schemas/payee" }, "payment_instruction": { "$ref": "#/components/schemas/payment_instruction" }, "description": { "type": "string", "description": "The purchase description.", "minLength": 1, "maxLength": 127 }, "custom_id": { "type": "string", "description": "The API caller-provided external ID. Used to reconcile API caller-initiated transactions with PayPal transactions. Appears in transaction and settlement reports.", "minLength": 1, "maxLength": 255 }, "invoice_id": { "type": "string", "description": "The API caller-provided external invoice ID for this order.", "minLength": 1, "maxLength": 127 }, "id": { "type": "string", "description": "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 v2/checkout/orders/id/save.", "minLength": 1, "maxLength": 19 }, "soft_descriptor": { "type": "string", "description": "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:22 - len(PAYPAL * (8)) - len(Descriptor in Payment Receiving Preferences of Merchant account + 1)The PAYPAL prefix uses 8 characters.

The soft descriptor supports the following ASCII characters:For Wallet payments marketplace integrations:
For unbranded payments (Direct Card) marketplace integrations, use a combination of the seller name and phone number.", "minLength": 1, "maxLength": 22 }, "items": { "$ref": "#/components/schemas/item_list" }, "shipping": { "description": "The shipping address and method.", "$ref": "#/components/schemas/shipping_with_tracking_details" }, "supplementary_data": { "description": "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.", "$ref": "#/components/schemas/supplementary_data" }, "payments": { "description": "The comprehensive history of payments for the purchase unit.", "readOnly": true, "$ref": "#/components/schemas/payment_collection" }, "most_recent_errors": { "$ref": "#/components/schemas/most_recent_error_list" } } }, "purchase_unit_list": { "type": "array", "description": "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.", "minItems": 1, "maxItems": 10, "items": { "$ref": "#/components/schemas/purchase_unit" } }, "purchase_unit_request": { "type": "object", "title": "Purchase Unit Request", "description": "The purchase unit request. Includes required information for the payment contract.", "properties": { "reference_id": { "type": "string", "description": "The API caller-provided external ID for the purchase unit. Required for multiple purchase units when you must update the order through `PATCH`. If you omit this value and the order contains only one purchase unit, PayPal sets this value to `default`.", "minLength": 1, "maxLength": 256 }, "amount": { "description": "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. The `amount.value` field supports up to 15 digits preceding the decimal. For a list of supported currencies, decimal precision, and maximum charge amount, see the PayPal REST APIs Currency Codes.", "$ref": "#/components/schemas/amount_with_breakdown" }, "payee": { "description": "The merchant who receives payment for this transaction.", "$ref": "#/components/schemas/payee" }, "payment_instruction": { "$ref": "#/components/schemas/payment_instruction" }, "description": { "type": "string", "description": "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.", "minLength": 1, "maxLength": 127 }, "custom_id": { "type": "string", "description": "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.", "minLength": 1, "maxLength": 255 }, "invoice_id": { "type": "string", "description": "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.", "minLength": 1, "maxLength": 127 }, "soft_descriptor": { "type": "string", "description": "The soft descriptor is the dynamic text used to construct the statement descriptor that appears on a payer's card statement.

If an Order is paid using the \"PayPal Wallet\", the statement descriptor will appear in following format on the payer's card statement: PAYPAL_prefix+(space)+merchant_descriptor+(space)+ soft_descriptor
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/edit
The PAYPAL prefix uses 8 characters. Only the first 22 characters will be displayed in the statement.
For example, if:Then, the statement descriptor on the card is PAYPAL * Janes Gift 80.", "minLength": 1, "maxLength": 22 }, "items": { "$ref": "#/components/schemas/item_list" }, "shipping": { "description": "The name and address of the person to whom to ship the items.", "$ref": "#/components/schemas/shipping_detail" }, "supplementary_data": { "description": "Contains Supplementary Data.", "$ref": "#/components/schemas/supplementary_data" } }, "required": ["amount"] }, "purchase_unit_request_list": { "type": "array", "description": "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.", "minItems": 1, "maxItems": 10, "items": { "$ref": "#/components/schemas/purchase_unit_request" } }, "qr_details": { "type": "object", "description": "QR details received from processor.", "title": "QR Details", "properties": { "qr_expiry": { "type": "string", "description": "QR Expiry time in seconds", "minLength": 3, "maxLength": 6, "pattern": "^[0-9]+$", "x-security-classification": { "data_class": "class4", "data_category": "INTRINSIC" } }, "qr_image": { "type": "string", "description": "QR image received from APM processor, The pattern is not provided because the value is defined by an external party.", "minLength": 20, "maxLength": 520, "pattern": "^.*$", "x-security-classification": { "data_class": "class4", "data_category": "INTRINSIC" } }, "qr_payload": { "type": "string", "description": "QR payload received from APM processor, The pattern is not provided because the value is defined by an external party.", "minLength": 20, "maxLength": 520, "pattern": "^.*$", "x-security-classification": { "data_class": "class4", "data_category": "INTRINSIC" } } } }, "refund": { "type": "object", "title": "Refund", "description": "The refund information.", "allOf": [ { "$ref": "#/components/schemas/refund_status" }, { "properties": { "id": { "description": "The PayPal-generated ID for the refund.", "type": "string", "readOnly": true }, "amount": { "description": "The amount that the payee refunded to the payer.", "$ref": "#/components/schemas/money", "readOnly": true }, "invoice_id": { "description": "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.", "type": "string", "readOnly": true }, "custom_id": { "type": "string", "description": "The API caller-provided external ID. Used to reconcile API caller-initiated transactions with PayPal transactions. Appears in transaction and settlement reports.", "minLength": 1, "maxLength": 255, "pattern": "^[A-Za-z0-9-_.,]*$" }, "acquirer_reference_number": { "type": "string", "description": "Reference ID issued for the card transaction. This ID can be used to track the transaction across processors, card brands and issuing banks.", "minLength": 1, "maxLength": 36, "pattern": "^[a-zA-Z0-9]+$" }, "note_to_payer": { "description": "The reason for the refund. Appears in both the payer's transaction history and the emails that the payer receives.", "type": "string", "readOnly": true }, "seller_payable_breakdown": { "$ref": "#/components/schemas/seller_payable_breakdown" }, "payer": { "description": "The details associated with the merchant for this transaction.", "$ref": "#/components/schemas/payee_base", "readOnly": true }, "links": { "$ref": "#/components/schemas/refund_definitions-link_description_list" } } }, { "$ref": "#/components/schemas/activity_timestamps" } ] }, "refund_definitions-link_description_list": { "description": "An array of related [HATEOAS links](/docs/api/reference/api-responses/#hateoas-links).", "type": "array", "readOnly": true, "items": { "$ref": "#/components/schemas/link_description" } }, "refund_definitions-platform_fee_list": { "type": "array", "description": "An array of platform or partner fees, commissions, or brokerage fees for the refund.", "minItems": 0, "maxItems": 1, "items": { "$ref": "#/components/schemas/platform_fee" } }, "refund_list": { "type": "array", "description": "An array of refunds for a purchase unit. A purchase unit can have zero or more refunds.", "items": { "$ref": "#/components/schemas/refund" } }, "refund_status": { "type": "object", "description": "The refund status with details.", "title": "Refund Status With Details", "properties": { "status": { "title": "Refund Status With Details", "description": "The status of the refund.", "type": "string", "x-enumDescriptions": [ { "value": "CANCELLED", "description": "The refund was cancelled." }, { "value": "FAILED", "description": "The refund could not be processed." }, { "value": "PENDING", "description": "The refund is pending. For more information, see status_details.reason." }, { "value": "COMPLETED", "description": "The funds for this transaction were debited to the customer's account." } ], "readOnly": true, "enum": ["CANCELLED", "FAILED", "PENDING", "COMPLETED"] }, "status_details": { "description": "The details of the refund status.", "readOnly": true, "$ref": "#/components/schemas/refund_status_details" } } }, "refund_status_details": { "title": "Refund Status Details", "description": "The details of the refund status.", "type": "object", "properties": { "reason": { "title": "Refund Incomplete Reason", "description": "The reason why the refund has the `PENDING` or `FAILED` status.", "type": "string", "x-enumDescriptions": [ { "value": "ECHECK", "description": "The customer's account is funded through an eCheck, which has not yet cleared." } ], "enum": ["ECHECK"] } } }, "risk_supplementary_data": { "type": "object", "title": "Risk Supplementary Data", "description": "Additional information necessary to evaluate the risk profile of a transaction.", "properties": { "customer": { "$ref": "#/components/schemas/participant_metadata" } } }, "seller_payable_breakdown": { "description": "The breakdown of the refund.", "type": "object", "title": "Seller Payable Breakdown", "properties": { "gross_amount": { "description": "The amount that the payee refunded to the payer.", "$ref": "#/components/schemas/money", "readOnly": true }, "paypal_fee": { "description": "The PayPal fee that was refunded to the payer in the currency of the transaction. This fee might not match the PayPal fee that the payee paid when the payment was captured.", "$ref": "#/components/schemas/money", "readOnly": true }, "paypal_fee_in_receivable_currency": { "description": "The PayPal fee that was refunded to the payer in the receivable currency. Returned only in cases when the receivable currency is different from transaction currency. Example 'CNY'.", "$ref": "#/components/schemas/money", "readOnly": true }, "net_amount": { "description": "The net amount that the payee's account is debited in the transaction currency. The net amount is calculated as gross_amount minus paypal_fee minus platform_fees.", "$ref": "#/components/schemas/money", "readOnly": true }, "net_amount_in_receivable_currency": { "description": "The net amount that the payee's account is debited in the receivable currency. Returned only in cases when the receivable currency is different from transaction currency. Example 'CNY'.", "$ref": "#/components/schemas/money", "readOnly": true }, "platform_fees": { "$ref": "#/components/schemas/refund_definitions-platform_fee_list" }, "net_amount_breakdown": { "$ref": "#/components/schemas/net_amount_breakdown_item_list" }, "total_refunded_amount": { "description": "The total amount refunded from the original capture to date. For example, if a payer makes a $100 purchase and was refunded $20 a week ago and was refunded $30 in this refund, the `gross_amount` is $30 for this refund and the `total_refunded_amount` is $50.", "$ref": "#/components/schemas/money" } }, "readOnly": true }, "seller_protection": { "type": "object", "description": "The level of protection offered as defined by [PayPal Seller Protection for Merchants](https://www.paypal.com/us/webapps/mpp/security/seller-protection).", "title": "Seller Protection", "properties": { "status": { "title": "Seller Protection Status", "type": "string", "description": "Indicates whether the transaction is eligible for seller protection. For information, see [PayPal Seller Protection for Merchants](https://www.paypal.com/us/webapps/mpp/security/seller-protection).", "x-enumDescriptions": [ { "value": "ELIGIBLE", "description": "Your PayPal balance remains intact if the customer claims that they did not receive an item or the account holder claims that they did not authorize the payment." }, { "value": "PARTIALLY_ELIGIBLE", "description": "Your PayPal balance remains intact if the customer claims that they did not receive an item." }, { "value": "NOT_ELIGIBLE", "description": "This transaction is not eligible for seller protection." } ], "readOnly": true, "enum": ["ELIGIBLE", "PARTIALLY_ELIGIBLE", "NOT_ELIGIBLE"] }, "dispute_categories": { "$ref": "#/components/schemas/dispute_categories_list" } } }, "seller_receivable_breakdown": { "type": "object", "title": "Seller Receivable Breakdown", "description": "The detailed breakdown of the capture activity. This is not available for transactions that are in pending state.", "properties": { "gross_amount": { "description": "The amount for this captured payment in the currency of the transaction.", "$ref": "#/components/schemas/money" }, "paypal_fee": { "description": "The applicable fee for this captured payment in the currency of the transaction.", "$ref": "#/components/schemas/money" }, "paypal_fee_in_receivable_currency": { "description": "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'.", "$ref": "#/components/schemas/money" }, "net_amount": { "description": "The net amount that the payee receives for this captured payment in their PayPal account. The net amount is computed as gross_amount minus the paypal_fee minus the platform_fees.", "$ref": "#/components/schemas/money" }, "receivable_amount": { "description": "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 net_amount times exchange_rate.", "$ref": "#/components/schemas/money" }, "exchange_rate": { "description": "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.", "$ref": "#/components/schemas/exchange_rate" }, "platform_fees": { "$ref": "#/components/schemas/definitions-platform_fee_list" } }, "required": ["gross_amount"] }, "shipment_carrier": { "type": "string", "title": "Carrier.", "description": "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.", "minLength": 1, "maxLength": 64, "pattern": "^[0-9A-Z_]+$", "x-enumDescriptions": [ { "value": "DPD_RU", "description": "DPD Russia." }, { "value": "BG_BULGARIAN_POST", "description": "Bulgarian Posts." }, { "value": "KR_KOREA_POST", "description": "Koreapost (www.koreapost.go.kr)." }, { "value": "ZA_COURIERIT", "description": "Courier IT." }, { "value": "FR_EXAPAQ", "description": "DPD France (formerly exapaq)." }, { "value": "ARE_EMIRATES_POST", "description": "Emirates Post." }, { "value": "GAC", "description": "GAC." }, { "value": "GEIS", "description": "Geis CZ." }, { "value": "SF_EX", "description": "SF Express." }, { "value": "PAGO", "description": "Pago Logistics." }, { "value": "MYHERMES", "description": "MyHermes UK." }, { "value": "DIAMOND_EUROGISTICS", "description": "Diamond Eurogistics Limited." }, { "value": "CORPORATECOURIERS_WEBHOOK", "description": "Corporate Couriers." }, { "value": "BOND", "description": "Bond courier." }, { "value": "OMNIPARCEL", "description": "Omni Parcel." }, { "value": "SK_POSTA", "description": "Slovenska pošta." }, { "value": "PUROLATOR", "description": "purolator." }, { "value": "FETCHR_WEBHOOK", "description": "Mena 360 (Fetchr)." }, { "value": "THEDELIVERYGROUP", "description": "TDG – The Delivery Group." }, { "value": "CELLO_SQUARE", "description": "Cello Square." }, { "value": "TARRIVE", "description": "TONDA GLOBAL." }, { "value": "COLLIVERY", "description": "MDS Collivery Pty (Ltd)." }, { "value": "MAINFREIGHT", "description": "Mainfreight." }, { "value": "IND_FIRSTFLIGHT", "description": "First Flight Couriers." }, { "value": "ACSWORLDWIDE", "description": "ACS Worldwide Express." }, { "value": "AMSTAN", "description": "Amstan Logistics." }, { "value": "OKAYPARCEL", "description": "OkayParcel." }, { "value": "ENVIALIA_REFERENCE", "description": "Envialia Reference." }, { "value": "SEUR_ES", "description": "Seur Spain." }, { "value": "CONTINENTAL", "description": "Continental." }, { "value": "FDSEXPRESS", "description": "FDSEXPRESS." }, { "value": "AMAZON_FBA_SWISHIP", "description": "Swiship UK." }, { "value": "WYNGS", "description": "Wyngs." }, { "value": "DHL_ACTIVE_TRACING", "description": "DHL Active Tracing." }, { "value": "ZYLLEM", "description": "Zyllem." }, { "value": "RUSTON", "description": "Ruston." }, { "value": "XPOST", "description": "Xpost.ph." }, { "value": "CORREOS_ES", "description": "correos Express (www.correos.es)." }, { "value": "DHL_FR", "description": "DHL France (www.dhl.com)." }, { "value": "PAN_ASIA", "description": "Pan-Asia International." }, { "value": "BRT_IT", "description": "BRT couriers Italy (www.brt.it)." }, { "value": "SRE_KOREA", "description": "SRE Korea (www.srekorea.co.kr)." }, { "value": "SPEEDEE", "description": "Spee-Dee Delivery." }, { "value": "TNT_UK", "description": "TNT UK Limited (www.tnt.com)." }, { "value": "VENIPAK", "description": "Venipak." }, { "value": "SHREENANDANCOURIER", "description": "SHREE NANDAN COURIER." }, { "value": "CROSHOT", "description": "Croshot." }, { "value": "NIPOST_NG", "description": "NIpost (www.nipost.gov.ng)." }, { "value": "EPST_GLBL", "description": "ePost Global." }, { "value": "NEWGISTICS", "description": "Newgistics." }, { "value": "POST_SLOVENIA", "description": "Post of Slovenia." }, { "value": "JERSEY_POST", "description": "Jersey Post." }, { "value": "BOMBINOEXP", "description": "Bombino Express Pvt." }, { "value": "WMG", "description": "WMG Delivery." }, { "value": "XQ_EXPRESS", "description": "XQ Express." }, { "value": "FURDECO", "description": "Furdeco." }, { "value": "LHT_EXPRESS", "description": "LHT Express." }, { "value": "SOUTH_AFRICAN_POST_OFFICE", "description": "South African Post Office." }, { "value": "SPOTON", "description": "SPOTON Logistics Pvt Ltd." }, { "value": "DIMERCO", "description": "Dimerco Express Group." }, { "value": "CYPRUS_POST_CYP", "description": "cyprus post." }, { "value": "ABCUSTOM", "description": "AB Custom Group." }, { "value": "IND_DELIVREE", "description": "deliverE." }, { "value": "CN_BESTEXPRESS", "description": "Best Express." }, { "value": "DX_SFTP", "description": "DX (SFTP)." }, { "value": "PICKUPP_MYS", "description": "PICK UPP." }, { "value": "FMX", "description": "FMX." }, { "value": "HELLMANN", "description": "Hellmann Worldwide Logistics." }, { "value": "SHIP_IT_ASIA", "description": "Ship It Asia." }, { "value": "KERRY_ECOMMERCE", "description": "Kerry eCommerce." }, { "value": "FRETERAPIDO", "description": "Frete Rapido." }, { "value": "PITNEY_BOWES", "description": "Pitney Bowes." }, { "value": "XPRESSEN_DK", "description": "Xpressen courier." }, { "value": "SEUR_SP_API", "description": "Spanish Seur API." }, { "value": "DELIVERYONTIME", "description": "DELIVERYONTIME LOGISTICS PVT LTD." }, { "value": "JINSUNG", "description": "JINSUNG TRADING." }, { "value": "TRANS_KARGO", "description": "Trans Kargo Internasional." }, { "value": "SWISHIP_DE", "description": "Swiship DE." }, { "value": "IVOY_WEBHOOK", "description": "Ivoy courier." }, { "value": "AIRMEE_WEBHOOK", "description": "Airmee couriers." }, { "value": "DHL_BENELUX", "description": "dhl benelux." }, { "value": "FIRSTMILE", "description": "FirstMile." }, { "value": "FASTWAY_IR", "description": "Fastway Ireland." }, { "value": "HH_EXP", "description": "Hua Han Logistics." }, { "value": "MYS_MYPOST_ONLINE", "description": "Mypostonline." }, { "value": "TNT_NL", "description": "THT Netherland." }, { "value": "TIPSA", "description": "TIPSA courier." }, { "value": "TAQBIN_MY", "description": "TAQBIN Malaysia." }, { "value": "KGMHUB", "description": "KGM Hub." }, { "value": "INTEXPRESS", "description": "Internet Express." }, { "value": "OVERSE_EXP", "description": "Overseas Express." }, { "value": "ONECLICK", "description": "One click delivery services." }, { "value": "ROADRUNNER_FREIGHT", "description": "Roadbull Logistics." }, { "value": "GLS_CROTIA", "description": "GLS Croatia." }, { "value": "MRW_FTP", "description": "MRW courier." }, { "value": "BLUEX", "description": "Blue Express." }, { "value": "DYLT", "description": "Daylight Transport." }, { "value": "DPD_IR", "description": "DPD Ireland." }, { "value": "SIN_GLBL", "description": "Sin Global Express." }, { "value": "TUFFNELLS_REFERENCE", "description": "Tuffnells Parcels Express- Reference." }, { "value": "CJPACKET", "description": "CJ Packet." }, { "value": "MILKMAN", "description": "Milkman courier." }, { "value": "ASIGNA", "description": "ASIGNA courier." }, { "value": "ONEWORLDEXPRESS", "description": "One World Express." }, { "value": "ROYAL_MAIL", "description": "RoyalShipments." }, { "value": "VIA_EXPRESS", "description": "Viaxpress." }, { "value": "TIGFREIGHT", "description": "TIG Freight." }, { "value": "ZTO_EXPRESS", "description": "ZTO Express." }, { "value": "TWO_GO", "description": "2GO Courier." }, { "value": "IML", "description": "IML courier." }, { "value": "INTEL_VALLEY", "description": "Intel-Valley Supply chain (ShenZhen) Co. Ltd." }, { "value": "EFS", "description": "EFS (E-commerce Fulfillment Service)." }, { "value": "UK_UK_MAIL", "description": "UK mail (ukmail.com)." }, { "value": "RAM", "description": "RAM courier." }, { "value": "ALLIEDEXPRESS", "description": "Allied Express." }, { "value": "APC_OVERNIGHT", "description": "APC overnight (apc-overnight.com)." }, { "value": "SHIPPIT", "description": "Shippit." }, { "value": "TFM", "description": "TFM Xpress." }, { "value": "M_XPRESS", "description": "M Xpress Sdn Bhd." }, { "value": "HDB_BOX", "description": "Haidaibao (BOX)." }, { "value": "CLEVY_LINKS", "description": "Clevy Links." }, { "value": "IBEONE", "description": "Beone Logistics." }, { "value": "FIEGE_NL", "description": "Fiege Netherlands." }, { "value": "KWE_GLOBAL", "description": "KWE Global." }, { "value": "CTC_EXPRESS", "description": "CTC Express." }, { "value": "AMAZON", "description": "Amazon Shipping." }, { "value": "MORE_LINK", "description": "Morelink." }, { "value": "JX", "description": "JX courier." }, { "value": "EASY_MAIL", "description": "Easy Mail." }, { "value": "ADUIEPYLE", "description": "A Duie Pyle." }, { "value": "GB_PANTHER", "description": "Panther." }, { "value": "EXPRESSSALE", "description": "Expresssale." }, { "value": "SG_DETRACK", "description": "Detrack." }, { "value": "TRUNKRS_WEBHOOK", "description": "Trunkrs courier." }, { "value": "MATDESPATCH", "description": "Matdespatch." }, { "value": "DICOM", "description": "GLS Logistic Systems Canada Ltd./Dicom." }, { "value": "MBW", "description": "MBW Courier Inc.." }, { "value": "KHM_CAMBODIA_POST", "description": "Cambodia Post." }, { "value": "SINOTRANS", "description": "Sinotrans." }, { "value": "BRT_IT_PARCELID", "description": "BRT Bartolini(Parcel ID)." }, { "value": "DHL_SUPPLY_CHAIN", "description": "DHL Supply Chain APAC." }, { "value": "DHL_PL", "description": "DHL Poland." }, { "value": "TOPYOU", "description": "TopYou." }, { "value": "PALEXPRESS", "description": "PAL Express Limited." }, { "value": "DHL_SG", "description": "dhl Singapore." }, { "value": "CN_WEDO", "description": "WeDo Logistics." }, { "value": "FULFILLME", "description": "Fulfillme." }, { "value": "DPD_DELISTRACK", "description": "DPD delistrack." }, { "value": "UPS_REFERENCE", "description": "UPS Reference." }, { "value": "CARIBOU", "description": "Caribou." }, { "value": "LOCUS_WEBHOOK", "description": "Locus courier." }, { "value": "DSV", "description": "DSV courier." }, { "value": "P2P_TRC", "description": "P2P TrakPak." }, { "value": "DIRECTPARCELS", "description": "Direct Parcels." }, { "value": "NOVA_POSHTA_INT", "description": "Nova Poshta (International)." }, { "value": "FEDEX_POLAND", "description": "FedEx® Poland Domestic." }, { "value": "CN_JCEX", "description": "JCEX courier." }, { "value": "FAR_INTERNATIONAL", "description": "FAR international." }, { "value": "IDEXPRESS", "description": "IDEX courier." }, { "value": "GANGBAO", "description": "GANGBAO Supplychain." }, { "value": "NEWAY", "description": "Neway Transport." }, { "value": "POSTNL_INT_3_S", "description": "PostNL International." }, { "value": "RPX_ID", "description": "RPX Indonesia." }, { "value": "DESIGNERTRANSPORT_WEBHOOK", "description": "Designer Transport." }, { "value": "GLS_SLOVEN", "description": "GLS Slovenia." }, { "value": "PARCELLED_IN", "description": "Parcelled.in." }, { "value": "GSI_EXPRESS", "description": "GSI EXPRESS." }, { "value": "CON_WAY", "description": "Con-way Freight." }, { "value": "BROUWER_TRANSPORT", "description": "Brouwer Transport en Logistiek." }, { "value": "CPEX", "description": "Captain Express International." }, { "value": "ISRAEL_POST", "description": "Israel Post." }, { "value": "DTDC_IN", "description": "DTDC India." }, { "value": "PTT_POST", "description": "PTT Post." }, { "value": "XDE_WEBHOOK", "description": "Ximex Delivery Express." }, { "value": "TOLOS", "description": "Tolos courier." }, { "value": "GIAO_HANG", "description": "Giao hàng nhanh." }, { "value": "GEODIS_ESPACE", "description": "Geodis E-space." }, { "value": "MAGYAR_HU", "description": "Magyar Post." }, { "value": "DOORDASH_WEBHOOK", "description": "DoorDash." }, { "value": "TIKI_ID", "description": "Tiki shipment." }, { "value": "CJ_HK_INTERNATIONAL", "description": "CJ Logistics International(Hong Kong)." }, { "value": "STAR_TRACK_EXPRESS", "description": "Star Track Express." }, { "value": "HELTHJEM", "description": "Helthjem." }, { "value": "SFB2C", "description": "SF International." }, { "value": "FREIGHTQUOTE", "description": "Freightquote by C.H. Robinson." }, { "value": "LANDMARK_GLOBAL_REFERENCE", "description": "Landmark Global Reference." }, { "value": "PARCEL2GO", "description": "Parcel2Go." }, { "value": "DELNEXT", "description": "Delnext." }, { "value": "RCL", "description": "Red Carpet Logistics." }, { "value": "CGS_EXPRESS", "description": "CGS Express." }, { "value": "HK_POST", "description": "Hongkong Post (www.hongkongpost.hk)." }, { "value": "SAP_EXPRESS", "description": "SAP EXPRESS." }, { "value": "PARCELPOST_SG", "description": "Parcel Post Singapore." }, { "value": "HERMES", "description": "HermesWorld UK." }, { "value": "IND_SAFEEXPRESS", "description": "Safexpress." }, { "value": "TOPHATTEREXPRESS", "description": "Tophatter Express." }, { "value": "MGLOBAL", "description": "PT MGLOBAL LOGISTICS INDONESIA." }, { "value": "AVERITT", "description": "Averitt Express." }, { "value": "LEADER", "description": "leader." }, { "value": "_2EBOX", "description": "2ebox courier." }, { "value": "SG_SPEEDPOST", "description": "Singapore Speedpost." }, { "value": "DBSCHENKER_SE", "description": "DB Schenker (www.dbschenker.com)." }, { "value": "ISR_POST_DOMESTIC", "description": "Israel Post Domestic." }, { "value": "BESTWAYPARCEL", "description": "Best Way Parcel." }, { "value": "ASENDIA_DE", "description": "asendia_de." }, { "value": "NIGHTLINE_UK", "description": "nightline_uk." }, { "value": "TAQBIN_SG", "description": "taqbin_sg." }, { "value": "TCK_EXPRESS", "description": "TCK Express." }, { "value": "ENDEAVOUR_DELIVERY", "description": "Endeavour Delivery." }, { "value": "NANJINGWOYUAN", "description": "Nanjing Woyuan." }, { "value": "HEPPNER_FR", "description": "Heppner France." }, { "value": "EMPS_CN", "description": "EMPS Express." }, { "value": "FONSEN", "description": "Fonsen Logistics." }, { "value": "PICKRR", "description": "Pickrr." }, { "value": "APC_OVERNIGHT_CONNUM", "description": "APC Overnight Consignment." }, { "value": "STAR_TRACK_NEXT_FLIGHT", "description": "Star Track Next Flight." }, { "value": "DAJIN", "description": "Shanghai Aqrum Chemical Logistics Co.Ltd." }, { "value": "UPS_FREIGHT", "description": "UPS Freight." }, { "value": "POSTA_PLUS", "description": "Posta Plus." }, { "value": "CEVA", "description": "CEVA LOGISTICS." }, { "value": "ANSERX", "description": "ANSERX courier." }, { "value": "JS_EXPRESS", "description": "JS EXPRESS." }, { "value": "PADTF", "description": "padtf.com." }, { "value": "UPS_MAIL_INNOVATIONS", "description": "UPS Mail Innovations." }, { "value": "SYPOST", "description": "Sunyou Post." }, { "value": "AMAZON_SHIP_MCF", "description": "Amazon Shipping + Amazon MCF." }, { "value": "YUSEN", "description": "Yusen Logistics." }, { "value": "BRING", "description": "Bring." }, { "value": "SDA_IT", "description": "SDA Italy." }, { "value": "GBA", "description": "GBA Services Ltd." }, { "value": "NEWEGGEXPRESS", "description": "Newegg Express." }, { "value": "SPEEDCOURIERS_GR", "description": "Speed Couriers." }, { "value": "FORRUN", "description": "forrun Pvt Ltd (Arpatech Venture)." }, { "value": "PICKUP", "description": "Pickupp." }, { "value": "ECMS", "description": "ECMS International Logistics Co.." }, { "value": "INTELIPOST", "description": "Intelipost (TMS for LATAM)." }, { "value": "FLASHEXPRESS", "description": "Flash Express." }, { "value": "CN_STO", "description": "STO Express." }, { "value": "SEKO_SFTP", "description": "SEKO Worldwide." }, { "value": "HOME_DELIVERY_SOLUTIONS", "description": "Home Delivery Solutions Ltd." }, { "value": "DPD_HGRY", "description": "DPD Hungary." }, { "value": "KERRYTTC_VN", "description": "Kerry Express (Vietnam) Co Ltd." }, { "value": "JOYING_BOX", "description": "Joying Box." }, { "value": "TOTAL_EXPRESS", "description": "Total Express." }, { "value": "ZJS_EXPRESS", "description": "ZJS International." }, { "value": "STARKEN", "description": "STARKEN couriers." }, { "value": "DEMANDSHIP", "description": "DemandShip." }, { "value": "CN_DPEX", "description": "DPEX." }, { "value": "AUPOST_CN", "description": "AuPost China." }, { "value": "LOGISTERS", "description": "Logisters." }, { "value": "GOGLOBALPOST", "description": "Global Post." }, { "value": "GLS_CZ", "description": "GLS Czech Republic." }, { "value": "PAACK_WEBHOOK", "description": "Paack courier." }, { "value": "GRAB_WEBHOOK", "description": "Grab courier." }, { "value": "PARCELPOINT", "description": "Parcelpoint." }, { "value": "ICUMULUS", "description": "iCumulus." }, { "value": "DAIGLOBALTRACK", "description": "DAI Post." }, { "value": "GLOBAL_IPARCEL", "description": "i-parcel." }, { "value": "YURTICI_KARGO", "description": "Yurtici Kargo." }, { "value": "CN_PAYPAL_PACKAGE", "description": "PayPal Package." }, { "value": "PARCEL_2_POST", "description": "Parcel To Post." }, { "value": "GLS_IT", "description": "GLS Italy." }, { "value": "PIL_LOGISTICS", "description": "PIL Logistics (China) Co.." }, { "value": "HEPPNER", "description": "Heppner Internationale Spedition GmbH & Co.." }, { "value": "GENERAL_OVERNIGHT", "description": "Go!Express and logistics." }, { "value": "HAPPY2POINT", "description": "Happy 2ThePoint." }, { "value": "CHITCHATS", "description": "Chit Chats." }, { "value": "SMOOTH", "description": "Smooth Couriers." }, { "value": "CLE_LOGISTICS", "description": "CL E-Logistics Solutions Limited." }, { "value": "FIEGE", "description": "Fiege Logistics." }, { "value": "MX_CARGO", "description": "M&X cargo." }, { "value": "ZIINGFINALMILE", "description": "Ziing Final Mile Inc." }, { "value": "DAYTON_FREIGHT", "description": "Dayton Freight." }, { "value": "TCS", "description": "TCS courier." }, { "value": "AEX", "description": "AEX Group." }, { "value": "HERMES_DE", "description": "Hermes Germany." }, { "value": "ROUTIFIC_WEBHOOK", "description": "Routific." }, { "value": "GLOBAVEND", "description": "Globavend." }, { "value": "CJ_LOGISTICS", "description": "CJ Logistics International." }, { "value": "PALLET_NETWORK", "description": "The Pallet Network." }, { "value": "RAF_PH", "description": "RAF Philippines." }, { "value": "UK_XDP", "description": "XDP Express." }, { "value": "PAPER_EXPRESS", "description": "Paper Express." }, { "value": "LA_POSTE_SUIVI", "description": "La Poste." }, { "value": "PAQUETEXPRESS", "description": "Paquetexpress." }, { "value": "LIEFERY", "description": "liefery." }, { "value": "STRECK_TRANSPORT", "description": "Streck Transport." }, { "value": "PONY_EXPRESS", "description": "Pony express." }, { "value": "ALWAYS_EXPRESS", "description": "Always Express." }, { "value": "GBS_BROKER", "description": "GBS-Broker." }, { "value": "CITYLINK_MY", "description": "City-Link Express." }, { "value": "ALLJOY", "description": "ALLJOY SUPPLY CHAIN." }, { "value": "YODEL", "description": "yodel." }, { "value": "YODEL_DIR", "description": "Yodel Direct." }, { "value": "STONE3PL", "description": "STONE3PL." }, { "value": "PARCELPAL_WEBHOOK", "description": "ParcelPal." }, { "value": "DHL_ECOMERCE_ASA", "description": "DHL eCommerce Asia (API)." }, { "value": "SIMPLYPOST", "description": "J&T Express Singapore." }, { "value": "KY_EXPRESS", "description": "Kua Yue Express." }, { "value": "SHENZHEN", "description": "shenzhen 1st International Logistics(Group)Co." }, { "value": "US_LASERSHIP", "description": "LaserShip." }, { "value": "UC_EXPRE", "description": "ucexpress." }, { "value": "DIDADI", "description": "DIDADI Logistics tech." }, { "value": "CJ_KR", "description": "CJ Korea Express." }, { "value": "DBSCHENKER_B2B", "description": "DB Schenker B2B." }, { "value": "MXE", "description": "MXE Express." }, { "value": "CAE_DELIVERS", "description": "CAE Delivers." }, { "value": "PFCEXPRESS", "description": "PFC Express." }, { "value": "WHISTL", "description": "Whistl." }, { "value": "WEPOST", "description": "WePost Sdn Bhd." }, { "value": "DHL_PARCEL_ES", "description": "DHL parcel Spain(www.dhl.com)." }, { "value": "DDEXPRESS", "description": "DD Express Courier." }, { "value": "ARAMEX_AU", "description": "Aramex Australia (formerly Fastway AU)." }, { "value": "BNEED", "description": "Bneed courier." }, { "value": "HK_TGX", "description": "Kerry Express Hong Kong." }, { "value": "LATVIJAS_PASTS", "description": "Latvijas Pasts." }, { "value": "VIAEUROPE", "description": "ViaEurope." }, { "value": "CORREO_UY", "description": "Correo Uruguayo." }, { "value": "CHRONOPOST_FR", "description": "Chronopost france (www.chronopost.fr)." }, { "value": "J_NET", "description": "J-Net." }, { "value": "_6LS", "description": "6ls.com." }, { "value": "BLR_BELPOST", "description": "Belpost." }, { "value": "BIRDSYSTEM", "description": "BirdSystem." }, { "value": "DOBROPOST", "description": "DobroPost." }, { "value": "WAHANA_ID", "description": "Wahana express (www.wahana.com)." }, { "value": "WEASHIP", "description": "Weaship." }, { "value": "SONICTL", "description": "Sonic Transportation & Logistics." }, { "value": "KWT", "description": "Shenzhen Jinghuada Logistics Co.." }, { "value": "AFLLOG_FTP", "description": "AFL LOGISTICS." }, { "value": "SKYNET_WORLDWIDE", "description": "SkyNet Worldwide Express." }, { "value": "NOVA_POSHTA", "description": "Nova Poshta (novaposhta.ua)." }, { "value": "SEINO", "description": "Seino." }, { "value": "SZENDEX", "description": "SZENDEX." }, { "value": "BPOST_INT", "description": "Bpost international." }, { "value": "DBSCHENKER_SV", "description": "DB Schenker Sweden." }, { "value": "AO_DEUTSCHLAND", "description": "AO Deutschland." }, { "value": "EU_FLEET_SOLUTIONS", "description": "EU Fleet Solutions." }, { "value": "PCFCORP", "description": "PCF Final Mile." }, { "value": "LINKBRIDGE", "description": "Link Bridge(BeiJing)international logistics co.." }, { "value": "PRIMAMULTICIPTA", "description": "PT Prima Multi Cipta." }, { "value": "COUREX", "description": "Urbanfox." }, { "value": "ZAJIL_EXPRESS", "description": "Zajil Express Company." }, { "value": "COLLECTCO", "description": "CollectCo." }, { "value": "JTEXPRESS", "description": "J&T EXPRESS MALAYSIA." }, { "value": "FEDEX_UK", "description": "FedEx® UK." }, { "value": "USHIP", "description": "uShip courier." }, { "value": "PIXSELL", "description": "PIXSELL LOGISTICS." }, { "value": "SHIPTOR", "description": "Shiptor." }, { "value": "CDEK", "description": "CDEK courier." }, { "value": "VNM_VIETTELPOST", "description": "ViettelPost." }, { "value": "CJ_CENTURY", "description": "CJ Century." }, { "value": "GSO", "description": "GSO(GLS-USA)." }, { "value": "VIWO", "description": "VIWO IoT." }, { "value": "SKYBOX", "description": "SKYBOX." }, { "value": "KERRYTJ", "description": "Kerry TJ Logistics." }, { "value": "NTLOGISTICS_VN", "description": "Nhat Tin Logistics." }, { "value": "SDH_SCM", "description": "lightning monkey." }, { "value": "ZINC", "description": "Zinc courier." }, { "value": "DPE_SOUTH_AFRC", "description": "DPE South Africa." }, { "value": "CESKA_CZ", "description": "Czech Post." }, { "value": "ACS_GR", "description": "ACS Courier." }, { "value": "DEALERSEND", "description": "DealerSend." }, { "value": "JOCOM", "description": "Jocom." }, { "value": "CSE", "description": "CSE courier." }, { "value": "TFORCE_FINALMILE", "description": "TForce Final Mile." }, { "value": "SHIP_GATE", "description": "ShipGate." }, { "value": "SHIPTER", "description": "SHIPTER." }, { "value": "NATIONAL_SAMEDAY", "description": "National Sameday." }, { "value": "YUNEXPRESS", "description": "YunExpress." }, { "value": "CAINIAO", "description": "AliExpress Standard Shipping." }, { "value": "DMS_MATRIX", "description": "DMSMatrix." }, { "value": "DIRECTLOG", "description": "Directlog (www.directlog.com.br)." }, { "value": "ASENDIA_US", "description": "Asendia USA." }, { "value": "_3JMSLOGISTICS", "description": "3JMS Logistics." }, { "value": "LICCARDI_EXPRESS", "description": "LICCARDI EXPRESS COURIER." }, { "value": "SKY_POSTAL", "description": "SkyPostal." }, { "value": "CNWANGTONG", "description": "cnwangtong." }, { "value": "POSTNORD_LOGISTICS_DK", "description": "ostnord denmark." }, { "value": "LOGISTIKA", "description": "Logistika." }, { "value": "CELERITAS", "description": "Celeritas Transporte." }, { "value": "PRESSIODE", "description": "Pressio." }, { "value": "SHREE_MARUTI", "description": "Shree Maruti Courier Services Pvt Ltd." }, { "value": "LOGISTICSWORLDWIDE_HK", "description": "Logistic Worldwide Express (LWE Honkong)." }, { "value": "EFEX", "description": "eFEx (E-Commerce Fulfillment & Express)." }, { "value": "LOTTE", "description": "Lotte Global Logistics." }, { "value": "LONESTAR", "description": "Lone Star Overnight." }, { "value": "APRISAEXPRESS", "description": "Aprisa Express." }, { "value": "BEL_RS", "description": "BEL North Russia." }, { "value": "OSM_WORLDWIDE", "description": "OSM Worldwide." }, { "value": "WESTGATE_GL", "description": "Westgate Global." }, { "value": "FASTRACK", "description": "Fasttrack." }, { "value": "DTD_EXPR", "description": "DTD Express." }, { "value": "ALFATREX", "description": "AlfaTrex." }, { "value": "PROMEDDELIVERY", "description": "ProMed Delivery." }, { "value": "THABIT_LOGISTICS", "description": "Thabit Logistics." }, { "value": "HCT_LOGISTICS", "description": "HCT LOGISTICS CO.LTD.." }, { "value": "CARRY_FLAP", "description": "Carry-Flap Co.." }, { "value": "US_OLD_DOMINION", "description": "Old Dominion Freight Line." }, { "value": "ANICAM_BOX", "description": "ANICAM BOX EXPRESS." }, { "value": "WANBEXPRESS", "description": "WanbExpress." }, { "value": "AN_POST", "description": "An Post." }, { "value": "DPD_LOCAL", "description": "DPD Local." }, { "value": "STALLIONEXPRESS", "description": "Stallion Express." }, { "value": "RAIDEREX", "description": "RaidereX." }, { "value": "SHOPFANS", "description": "ShopfansRU LLC." }, { "value": "KYUNGDONG_PARCEL", "description": "Kyungdong Parcel." }, { "value": "CHAMPION_LOGISTICS", "description": "Champion Logistics." }, { "value": "PICKUPP_SGP", "description": "PICK UPP (Singapore)." }, { "value": "MORNING_EXPRESS", "description": "Morning Express." }, { "value": "NACEX", "description": "NACEX." }, { "value": "THENILE_WEBHOOK", "description": "SortHub courier." }, { "value": "HOLISOL", "description": "Holisol." }, { "value": "LBCEXPRESS_FTP", "description": "LBC EXPRESS INC.." }, { "value": "KURASI", "description": "KURASI." }, { "value": "USF_REDDAWAY", "description": "USF Reddaway." }, { "value": "APG", "description": "APG eCommerce Solutions." }, { "value": "CN_BOXC", "description": "BoxC courier." }, { "value": "ECOSCOOTING", "description": "ECOSCOOTING." }, { "value": "MAINWAY", "description": "Mainway." }, { "value": "PAPERFLY", "description": "Paperfly Private Limited." }, { "value": "HOUNDEXPRESS", "description": "Hound Express." }, { "value": "BOX_BERRY", "description": "Boxberry courier." }, { "value": "EP_BOX", "description": "EP-Box courier." }, { "value": "PLUS_LOG_UK", "description": "Plus UK Logistics." }, { "value": "FULFILLA", "description": "Fulfilla." }, { "value": "ASE", "description": "ASE KARGO." }, { "value": "MAIL_PLUS", "description": "MailPlus." }, { "value": "XPO_LOGISTICS", "description": "XPO logistics." }, { "value": "WNDIRECT", "description": "wnDirect." }, { "value": "CLOUDWISH_ASIA", "description": "Cloudwish Asia." }, { "value": "ZELERIS", "description": "Zeleris." }, { "value": "GIO_EXPRESS", "description": "Gio Express." }, { "value": "OCS_WORLDWIDE", "description": "OCS WORLDWIDE." }, { "value": "ARK_LOGISTICS", "description": "ARK Logistics." }, { "value": "AQUILINE", "description": "Aquiline." }, { "value": "PILOT_FREIGHT", "description": "Pilot Freight Services." }, { "value": "QWINTRY", "description": "Qwintry Logistics." }, { "value": "DANSKE_FRAGT", "description": "Danske Fragtaend." }, { "value": "CARRIERS", "description": "Carriers courier." }, { "value": "AIR_CANADA_GLOBAL", "description": "Rivo (Air canada)." }, { "value": "PRESIDENT_TRANS", "description": "PRESIDENT TRANSNET CORP." }, { "value": "STEPFORWARDFS", "description": "STEP FORWARD FREIGHT SERVICE CO LTD." }, { "value": "SKYNET_UK", "description": "Skynet UK." }, { "value": "PITTOHIO", "description": "PITT OHIO." }, { "value": "CORREOS_EXPRESS", "description": "Correos Express." }, { "value": "RL_US", "description": "RL Carriers." }, { "value": "DESTINY", "description": "Destiny Transportation." }, { "value": "UK_YODEL", "description": "Yodel (www.yodel.co.uk)." }, { "value": "COMET_TECH", "description": "CometTech." }, { "value": "DHL_PARCEL_RU", "description": "DHL Parcel Russia." }, { "value": "TNT_REFR", "description": "TNT Reference." }, { "value": "SHREE_ANJANI_COURIER", "description": "Shree Anjani Courier." }, { "value": "MIKROPAKKET_BE", "description": "Mikropakket Belgium." }, { "value": "ETS_EXPRESS", "description": "RETS express." }, { "value": "COLIS_PRIVE", "description": "Colis Privé." }, { "value": "CN_YUNDA", "description": "Yunda Express." }, { "value": "AAA_COOPER", "description": "AAA Cooper." }, { "value": "ROCKET_PARCEL", "description": "Rocket Parcel International." }, { "value": "_360LION", "description": "360 Lion Express." }, { "value": "PANDU", "description": "PANDU." }, { "value": "PROFESSIONAL_COURIERS", "description": "PROFESSIONAL COURIERS." }, { "value": "FLYTEXPRESS", "description": "FLYTEXPRESS." }, { "value": "LOGISTICSWORLDWIDE_MY", "description": "LOGISTICSWORLDWIDE MY." }, { "value": "CORREOS_DE_ESPANA", "description": "CORREOS DE ESPANA." }, { "value": "IMX", "description": "IMX." }, { "value": "FOUR_PX_EXPRESS", "description": "FOUR PX EXPRESS." }, { "value": "XPRESSBEES", "description": "XPRESSBEES." }, { "value": "PICKUPP_VNM", "description": "pickupp_vnm." }, { "value": "STARTRACK_EXPRESS", "description": "startrack_express." }, { "value": "FR_COLISSIMO", "description": "fr_colissimo." }, { "value": "NACEX_SPAIN_REFERENCE", "description": "nacex_spain_reference." }, { "value": "DHL_SUPPLY_CHAIN_AU", "description": "dhl_supply_chain_au." }, { "value": "ESHIPPING", "description": "Eshipping." }, { "value": "SHREETIRUPATI", "description": "SHREE TIRUPATI COURIER SERVICES PVT. LTD.." }, { "value": "HX_EXPRESS", "description": "HX Express." }, { "value": "INDOPAKET", "description": "INDOPAKET." }, { "value": "CN_17POST", "description": "17 Post Service." }, { "value": "K1_EXPRESS", "description": "K1 Express." }, { "value": "CJ_GLS", "description": "CJ GLS." }, { "value": "MYS_GDEX", "description": "GDEX courier." }, { "value": "NATIONEX", "description": "Nationex courier." }, { "value": "ANJUN", "description": "Anjun couriers." }, { "value": "FARGOOD", "description": "FarGood." }, { "value": "SMG_EXPRESS", "description": "SMG Direct." }, { "value": "RZYEXPRESS", "description": "RZY Express." }, { "value": "SEFL", "description": "Southeastern Freight Lines." }, { "value": "TNT_CLICK_IT", "description": "TNT-Click Italy." }, { "value": "HDB", "description": "Haidaibao." }, { "value": "HIPSHIPPER", "description": "Hipshipper." }, { "value": "RPXLOGISTICS", "description": "RPX Logistics." }, { "value": "KUEHNE", "description": "Kuehne + Nagel." }, { "value": "IT_NEXIVE", "description": "Nexive (TNT Post Italy)." }, { "value": "PTS", "description": "PTS courier." }, { "value": "SWISS_POST_FTP", "description": "Swiss Post FTP." }, { "value": "FASTRK_SERV", "description": "Fastrak Services." }, { "value": "_4_72", "description": "4-72 Entregando." }, { "value": "US_YRC", "description": "YRC courier." }, { "value": "POSTNL_INTL_3S", "description": "PostNL International 3S." }, { "value": "ELIAN_POST", "description": "Yilian (Elian) Supply Chain." }, { "value": "CUBYN", "description": "Cubyn." }, { "value": "SAU_SAUDI_POST", "description": "Saudi Post." }, { "value": "ABXEXPRESS_MY", "description": "ABX Express." }, { "value": "HUAHAN_EXPRESS", "description": "HUAHANG EXPRESS." }, { "value": "ZES_EXPRESS", "description": "Eshun international Logistic." }, { "value": "ZEPTO_EXPRESS", "description": "ZeptoExpress." }, { "value": "SKYNET_ZA", "description": "Skynet World Wide Express South Africa." }, { "value": "ZEEK_2_DOOR", "description": "Zeek2Door." }, { "value": "BLINKLASTMILE", "description": "Blink." }, { "value": "POSTA_UKR", "description": "UkrPoshta." }, { "value": "CHROBINSON", "description": "C.H. Robinson Worldwide." }, { "value": "CN_POST56", "description": "Post56." }, { "value": "COURANT_PLUS", "description": "Courant Plus." }, { "value": "SCUDEX_EXPRESS", "description": "Scudex Express." }, { "value": "SHIPENTEGRA", "description": "ShipEntegra." }, { "value": "B_TWO_C_EUROPE", "description": "B2C courier Europe." }, { "value": "COPE", "description": "Cope Sensitive Freight." }, { "value": "IND_GATI", "description": "Gati-KWE." }, { "value": "CN_WISHPOST", "description": "WishPost." }, { "value": "NACEX_ES", "description": "NACEX Spain." }, { "value": "TAQBIN_HK", "description": "TAQBIN Hong Kong." }, { "value": "GLOBALTRANZ", "description": "GlobalTranz." }, { "value": "HKD", "description": "Qingdao HKD International Logistics." }, { "value": "BJSHOMEDELIVERY", "description": "BJS Distribution courier." }, { "value": "OMNIVA", "description": "Omniva." }, { "value": "SUTTON", "description": "Sutton Transport." }, { "value": "PANTHER_REFERENCE", "description": "Panther Reference." }, { "value": "SFCSERVICE", "description": "SFC Service." }, { "value": "LTL", "description": "LTL COURIER." }, { "value": "PARKNPARCEL", "description": "Park N Parcel." }, { "value": "SPRING_GDS", "description": "Spring GDS." }, { "value": "ECEXPRESS", "description": "ECexpress." }, { "value": "INTERPARCEL_AU", "description": "Interparcel Australia." }, { "value": "AGILITY", "description": "Agility." }, { "value": "XL_EXPRESS", "description": "XL Express." }, { "value": "ADERONLINE", "description": "Ader couriers." }, { "value": "DIRECTCOURIERS", "description": "Direct Couriers." }, { "value": "PLANZER", "description": "Planzer Group." }, { "value": "SENDING", "description": "Sending Transporte Urgente y Comunicacion." }, { "value": "NINJAVAN_WB", "description": "Ninjavan Webhook." }, { "value": "NATIONWIDE_MY", "description": "Nationwide Express Courier Services Bhd (www.nationwide.com.my)." }, { "value": "SENDIT", "description": "Sendit." }, { "value": "GB_ARROW", "description": "Arrow XL." }, { "value": "IND_GOJAVAS", "description": "GoJavas." }, { "value": "KPOST", "description": "Korea Post." }, { "value": "DHL_FREIGHT", "description": "DHL Freight." }, { "value": "BLUECARE", "description": "Bluecare Express Ltd." }, { "value": "JINDOUYUN", "description": "jindouyun courier." }, { "value": "TRACKON", "description": "Trackon Couriers Pvt. Ltd." }, { "value": "GB_TUFFNELLS", "description": "Tuffnells Parcels Express." }, { "value": "TRUMPCARD", "description": "TRUMPCARD LLC." }, { "value": "ETOTAL", "description": "eTotal Solution Limited." }, { "value": "SFPLUS_WEBHOOK", "description": "Zeek courier." }, { "value": "SEKOLOGISTICS", "description": "SEKO Logistics." }, { "value": "HERMES_2MANN_HANDLING", "description": "Hermes Einrichtungs Service GmbH & Co. KG." }, { "value": "DPD_LOCAL_REF", "description": "DPD Local reference." }, { "value": "UDS", "description": "United Delivery Service." }, { "value": "ZA_SPECIALISED_FREIGHT", "description": "Specialised Freight." }, { "value": "THA_KERRY", "description": "Kerry Express Thailand." }, { "value": "PRT_INT_SEUR", "description": "SEUR International." }, { "value": "BRA_CORREIOS", "description": "Correios Brazil." }, { "value": "NZ_NZ_POST", "description": "New Zealand Post." }, { "value": "CN_EQUICK", "description": "Equick China." }, { "value": "MYS_EMS", "description": "Malaysia Post EMS / Pos Laju." }, { "value": "GB_NORSK", "description": "Norsk Global." }, { "value": "ESP_MRW", "description": "MRW spain." }, { "value": "ESP_PACKLINK", "description": "Packlink." }, { "value": "KANGAROO_MY", "description": "Kangaroo Worldwide Express." }, { "value": "RPX", "description": "RPX Online." }, { "value": "XDP_UK_REFERENCE", "description": "XDP Express Reference." }, { "value": "NINJAVAN_MY", "description": "ninja van (www.ninjavan.co)." }, { "value": "ADICIONAL", "description": "Adicional Logistics." }, { "value": "ROADBULL", "description": "Red Carpet Logistics." }, { "value": "YAKIT", "description": "Yakit courier." }, { "value": "MAILAMERICAS", "description": "MailAmericas." }, { "value": "MIKROPAKKET", "description": "Mikropakket." }, { "value": "DYNALOGIC", "description": "Dynamic Logistics." }, { "value": "DHL_ES", "description": "DHL Spain(www.dhl.com)." }, { "value": "DHL_PARCEL_NL", "description": "DHL Parcel NL." }, { "value": "DHL_GLOBAL_MAIL_ASIA", "description": "DHL Global Mail Asia (www.dhl.com)." }, { "value": "DAWN_WING", "description": "Dawn Wing." }, { "value": "GENIKI_GR", "description": "Geniki Taxydromiki." }, { "value": "HERMESWORLD_UK", "description": "hermesworld_uk." }, { "value": "ALPHAFAST", "description": "Alphafast (www.alphafast.com)." }, { "value": "BUYLOGIC", "description": "buylogic." }, { "value": "EKART", "description": "Ekart logistics (ekartlogistics.com)." }, { "value": "MEX_SENDA", "description": "mexico senda express." }, { "value": "SFC_LOGISTICS", "description": "SFC." }, { "value": "POST_SERBIA", "description": "Posta Serbia." }, { "value": "IND_DELHIVERY", "description": "Delhivery India." }, { "value": "DE_DPD_DELISTRACK", "description": "DPD Germany." }, { "value": "RPD2MAN", "description": "RPD2man Deliveries." }, { "value": "CN_SF_EXPRESS", "description": "SF Express (www.sf-express.com)." }, { "value": "YANWEN", "description": "Yanwen Logistics." }, { "value": "MYS_SKYNET", "description": "Skynet Malaysia." }, { "value": "CORREOS_DE_MEXICO", "description": "correos mexico." }, { "value": "CBL_LOGISTICA", "description": "CBL Logistica." }, { "value": "MEX_ESTAFETA", "description": "Estafeta (www.estafeta.com)." }, { "value": "AU_AUSTRIAN_POST", "description": "Austrian Post (Registered)." }, { "value": "RINCOS", "description": "Rincos." }, { "value": "NLD_DHL", "description": "DHL Netherland." }, { "value": "RUSSIAN_POST", "description": "Russian post." }, { "value": "COURIERS_PLEASE", "description": "CouriersPlease (couriersplease.com.au)." }, { "value": "POSTNORD_LOGISTICS", "description": "PostNord Logistics." }, { "value": "FEDEX", "description": "Fedex." }, { "value": "DPE_EXPRESS", "description": "DPE Express." }, { "value": "DPD", "description": "DPD." }, { "value": "ADSONE", "description": "ADSone." }, { "value": "IDN_JNE", "description": "JNE Express (Jalur Nugraha Ekakurir)." }, { "value": "THECOURIERGUY", "description": "The Courier Guy." }, { "value": "CNEXPS", "description": "CNE Express." }, { "value": "PRT_CHRONOPOST", "description": "Chronopost Portugal." }, { "value": "LANDMARK_GLOBAL", "description": "Landmark Global." }, { "value": "IT_DHL_ECOMMERCE", "description": "DHL International." }, { "value": "ESP_NACEX", "description": "NACEX Spain." }, { "value": "PRT_CTT", "description": "CTT Portugal." }, { "value": "BE_KIALA", "description": "Kiala." }, { "value": "ASENDIA_UK", "description": "Asendia UK." }, { "value": "GLOBAL_TNT", "description": "TNT global." }, { "value": "POSTUR_IS", "description": "Iceland Post." }, { "value": "EPARCEL_KR", "description": "eParcel Korea." }, { "value": "INPOST_PACZKOMATY", "description": "InPost Paczkomaty." }, { "value": "IT_POSTE_ITALIA", "description": "Poste italiane (www.poste.it)." }, { "value": "BE_BPOST", "description": "Bpost (www.bpost.be)." }, { "value": "PL_POCZTA_POLSKA", "description": "Poczta Polska (www.poczta-polska.pl)." }, { "value": "MYS_MYS_POST", "description": "Malaysia Post." }, { "value": "SG_SG_POST", "description": "Singapore Post." }, { "value": "THA_THAILAND_POST", "description": "Thailand Post (www.thailandpost.co.th)." }, { "value": "LEXSHIP", "description": "LexShip." }, { "value": "FASTWAY_NZ", "description": "Fastway New Zealand." }, { "value": "DHL_AU", "description": "DHL Supply Chain Australia." }, { "value": "COSTMETICSNOW", "description": "Cosmetics Now." }, { "value": "PFLOGISTICS", "description": "PFL." }, { "value": "LOOMIS_EXPRESS", "description": "Loomis Express." }, { "value": "GLS_ITALY", "description": "GLS Italy." }, { "value": "LINE", "description": "Line Clear Express & Logistics Sdn Bhd." }, { "value": "GEL_EXPRESS", "description": "Gel Express Logistik." }, { "value": "HUODULL", "description": "Huodull." }, { "value": "NINJAVAN_SG", "description": "Ninja van Singapore." }, { "value": "JANIO", "description": "Janio Asia." }, { "value": "AO_COURIER", "description": "AO Logistics." }, { "value": "BRT_IT_SENDER_REF", "description": "BRT Bartolini(Sender Reference)." }, { "value": "SAILPOST", "description": "SAILPOST." }, { "value": "LALAMOVE", "description": "Lalamove." }, { "value": "NEWZEALAND_COURIERS", "description": "NEW ZEALAND COURIERS." }, { "value": "ETOMARS", "description": "Etomars." }, { "value": "VIRTRANSPORT", "description": "VIR Transport." }, { "value": "WIZMO", "description": "Wizmo." }, { "value": "PALLETWAYS", "description": "Palletways." }, { "value": "I_DIKA", "description": "i-dika." }, { "value": "CFL_LOGISTICS", "description": "CFL Logistics." }, { "value": "GEMWORLDWIDE", "description": "GEM Worldwide." }, { "value": "GLOBAL_EXPRESS", "description": "Tai Wan Global Business." }, { "value": "LOGISTYX_TRANSGROUP", "description": "Transgroup courier." }, { "value": "WESTBANK_COURIER", "description": "West Bank Courier." }, { "value": "ARCO_SPEDIZIONI", "description": "Arco Spedizioni SP." }, { "value": "YDH_EXPRESS", "description": "YDH express." }, { "value": "PARCELINKLOGISTICS", "description": "Parcelink Logistics." }, { "value": "CNDEXPRESS", "description": "CND Express." }, { "value": "NOX_NIGHT_TIME_EXPRESS", "description": "NOX NightTimeExpress." }, { "value": "AERONET", "description": "Aeronet couriers." }, { "value": "LTIANEXP", "description": "LTIAN EXP." }, { "value": "INTEGRA2_FTP", "description": "Integra2." }, { "value": "PARCELONE", "description": "PARCEL ONE." }, { "value": "NOX_NACHTEXPRESS", "description": "Innight Express Germany GmbH (nox NachtExpress)." }, { "value": "CN_CHINA_POST_EMS", "description": "China Post." }, { "value": "CHUKOU1", "description": "Chukou1." }, { "value": "GLS_SLOV", "description": "GLS General Logistics Systems Slovakia s.r.o.." }, { "value": "ORANGE_DS", "description": "OrangeDS (Orange Distribution Solutions Inc)." }, { "value": "JOOM_LOGIS", "description": "Joom Logistics." }, { "value": "AUS_STARTRACK", "description": "StarTrack (startrack.com.au)." }, { "value": "DHL", "description": "dhl Global." }, { "value": "GB_APC", "description": "APC postal logistics germany." }, { "value": "BONDSCOURIERS", "description": "Bonds Courier Service (bondscouriers.com.au)." }, { "value": "JPN_JAPAN_POST", "description": "Japan Post." }, { "value": "USPS", "description": "United States Postal Service." }, { "value": "WINIT", "description": "WinIt." }, { "value": "ARG_OCA", "description": "OCA Argentina." }, { "value": "TW_TAIWAN_POST", "description": "Taiwan Post." }, { "value": "DMM_NETWORK", "description": "DMM Network." }, { "value": "TNT", "description": "TNT Express." }, { "value": "BH_POSTA", "description": "BH Posta (www.posta.ba)." }, { "value": "SWE_POSTNORD", "description": "Postnord sweden." }, { "value": "CA_CANADA_POST", "description": "Canada Post." }, { "value": "WISELOADS", "description": "Wiseloads." }, { "value": "ASENDIA_HK", "description": "Asendia HonKong." }, { "value": "NLD_GLS", "description": "GLS Netherland." }, { "value": "MEX_REDPACK", "description": "Redpack." }, { "value": "JET_SHIP", "description": "Jet-Ship Worldwide." }, { "value": "DE_DHL_EXPRESS", "description": "DHL Express." }, { "value": "NINJAVAN_THAI", "description": "Ninja van Thai." }, { "value": "RABEN_GROUP", "description": "Raben Group." }, { "value": "ESP_ASM", "description": "ASM(GLS Spain)." }, { "value": "HRV_HRVATSKA", "description": "Hrvatska posta." }, { "value": "GLOBAL_ESTES", "description": "Estes Express Lines." }, { "value": "LTU_LIETUVOS", "description": "Lietuvos pastas." }, { "value": "BEL_DHL", "description": "DHL Benelux." }, { "value": "AU_AU_POST", "description": "Australia Post." }, { "value": "SPEEDEXCOURIER", "description": "SPEEDEX couriers." }, { "value": "FR_COLIS", "description": "Colissimo." }, { "value": "ARAMEX", "description": "Aramex." }, { "value": "DPEX", "description": "DPEX (www.dpex.com)." }, { "value": "MYS_AIRPAK", "description": "Airpak Express." }, { "value": "CUCKOOEXPRESS", "description": "Cuckoo Express." }, { "value": "DPD_POLAND", "description": "DPD Poland." }, { "value": "NLD_POSTNL", "description": "PostNL International." }, { "value": "NIM_EXPRESS", "description": "Nim Express." }, { "value": "QUANTIUM", "description": "Quantium." }, { "value": "SENDLE", "description": "Sendle." }, { "value": "ESP_REDUR", "description": "Redur Spain." }, { "value": "MATKAHUOLTO", "description": "Matkahuolto." }, { "value": "CPACKET", "description": "Cpacket couriers." }, { "value": "POSTI", "description": "Posti courier." }, { "value": "HUNTER_EXPRESS", "description": "Hunter Express." }, { "value": "CHOIR_EXP", "description": "Choir Express Indonesia." }, { "value": "LEGION_EXPRESS", "description": "Legion Express." }, { "value": "AUSTRIAN_POST_EXPRESS", "description": "austrian post." }, { "value": "GRUPO", "description": "Grupo ampm." }, { "value": "POSTA_RO", "description": "Post Roman (www.posta-romana.ro)." }, { "value": "INTERPARCEL_UK", "description": "Interparcel UK." }, { "value": "GLOBAL_ABF", "description": "ABF Freight." }, { "value": "POSTEN_NORGE", "description": "Posten Norge (www.posten.no)." }, { "value": "XPERT_DELIVERY", "description": "Xpert Delivery." }, { "value": "DHL_REFR", "description": "DHl (Reference number)." }, { "value": "DHL_HK", "description": "DHL HonKong." }, { "value": "SKYNET_UAE", "description": "SKYNET UAE." }, { "value": "GOJEK", "description": "Gojek." }, { "value": "YODEL_INTNL", "description": "Yodel International." }, { "value": "JANCO", "description": "Janco Ecommerce." }, { "value": "YTO", "description": "YTO Express." }, { "value": "WISE_EXPRESS", "description": "Wise Express." }, { "value": "JTEXPRESS_VN", "description": "J&T Express Vietnam." }, { "value": "FEDEX_INTL_MLSERV", "description": "FedEx International MailService." }, { "value": "VAMOX", "description": "VAMOX." }, { "value": "AMS_GRP", "description": "AMS Group." }, { "value": "DHL_JP", "description": "DHL Japan." }, { "value": "HRPARCEL", "description": "HR Parcel." }, { "value": "GESWL", "description": "GESWL Express." }, { "value": "BLUESTAR", "description": "Blue Star." }, { "value": "CDEK_TR", "description": "CDEK TR." }, { "value": "DESCARTES", "description": "Innovel courier." }, { "value": "DELTEC_UK", "description": "Deltec Courier." }, { "value": "DTDC_EXPRESS", "description": "DTDC express." }, { "value": "TOURLINE", "description": "tourline." }, { "value": "BH_WORLDWIDE", "description": "B&H Worldwide." }, { "value": "OCS", "description": "OCS ANA Group." }, { "value": "YINGNUO_LOGISTICS", "description": "yingnuo logistics." }, { "value": "UPS", "description": "United Parcel Service." }, { "value": "TOLL", "description": "Toll IPEC." }, { "value": "PRT_SEUR", "description": "SEUR portugal." }, { "value": "DTDC_AU", "description": "DTDC Australia." }, { "value": "THA_DYNAMIC_LOGISTICS", "description": "Dynamic Logistics." }, { "value": "UBI_LOGISTICS", "description": "UBI Smart Parcel." }, { "value": "FEDEX_CROSSBORDER", "description": "FedEx Cross Border." }, { "value": "A1POST", "description": "A1Post." }, { "value": "TAZMANIAN_FREIGHT", "description": "Tazmanian Freight Systems." }, { "value": "CJ_INT_MY", "description": "CJ International malaysia." }, { "value": "SAIA_FREIGHT", "description": "Saia LTL Freight." }, { "value": "SG_QXPRESS", "description": "Qxpress." }, { "value": "NHANS_SOLUTIONS", "description": "Nhans Solutions." }, { "value": "DPD_FR", "description": "DPD France." }, { "value": "COORDINADORA", "description": "Coordinadora." }, { "value": "ANDREANI", "description": "Grupo logistico Andreani." }, { "value": "DOORA", "description": "Doora Logistics." }, { "value": "INTERPARCEL_NZ", "description": "Interparcel New Zealand." }, { "value": "PHL_JAMEXPRESS", "description": "Jam Express Philippines." }, { "value": "BEL_BELGIUM_POST", "description": "bel_belgium_post." }, { "value": "US_APC", "description": "us_apc." }, { "value": "IDN_POS", "description": "idn_pos." }, { "value": "FR_MONDIAL", "description": "fr_mondial." }, { "value": "DE_DHL", "description": "DE DHL." }, { "value": "HK_RPX", "description": "hk_rpx." }, { "value": "DHL_PIECEID", "description": "dhl_pieceid." }, { "value": "VNPOST_EMS", "description": "vnpost_ems." }, { "value": "RRDONNELLEY", "description": "rrdonnelley." }, { "value": "DPD_DE", "description": "dpd_de." }, { "value": "DELCART_IN", "description": "delcart_in." }, { "value": "IMEXGLOBALSOLUTIONS", "description": "imexglobalsolutions." }, { "value": "ACOMMERCE", "description": "ACOMMERCE." }, { "value": "EURODIS", "description": "eurodis." }, { "value": "CANPAR", "description": "CANPAR." }, { "value": "GLS", "description": "GLS." }, { "value": "IND_ECOM", "description": "Ecom Express." }, { "value": "ESP_ENVIALIA", "description": "Envialia." }, { "value": "DHL_UK", "description": "dhl UK." }, { "value": "SMSA_EXPRESS", "description": "SMSA Express." }, { "value": "TNT_FR", "description": "TNT France." }, { "value": "DEX_I", "description": "DEX-I courier." }, { "value": "BUDBEE_WEBHOOK", "description": "Budbee courier." }, { "value": "COPA_COURIER", "description": "Copa Airlines Courier." }, { "value": "VNM_VIETNAM_POST", "description": "Vietnam Post." }, { "value": "DPD_HK", "description": "DPD HongKong." }, { "value": "TOLL_NZ", "description": "Toll New Zealand." }, { "value": "ECHO", "description": "Echo courier." }, { "value": "FEDEX_FR", "description": "FedEx® Freight." }, { "value": "BORDEREXPRESS", "description": "Border Express." }, { "value": "MAILPLUS_JPN", "description": "MailPlus (Japan)." }, { "value": "TNT_UK_REFR", "description": "TNT UK Reference." }, { "value": "KEC", "description": "KEC courier." }, { "value": "DPD_RO", "description": "DPD Romania." }, { "value": "TNT_JP", "description": "TNT_JP." }, { "value": "TH_CJ", "description": "TH_CJ." }, { "value": "EC_CN", "description": "EC_CN." }, { "value": "FASTWAY_UK", "description": "FASTWAY_UK." }, { "value": "FASTWAY_US", "description": "FASTWAY_US." }, { "value": "GLS_DE", "description": "GLS_DE." }, { "value": "GLS_ES", "description": "GLS_ES." }, { "value": "GLS_FR", "description": "GLS_FR." }, { "value": "MONDIAL_BE", "description": "MONDIAL_BE." }, { "value": "SGT_IT", "description": "SGT_IT." }, { "value": "TNT_CN", "description": "TNT_CN." }, { "value": "TNT_DE", "description": "TNT_DE." }, { "value": "TNT_ES", "description": "TNT_ES." }, { "value": "TNT_PL", "description": "TNT_PL." }, { "value": "PARCELFORCE", "description": "PARCELFORCE." }, { "value": "SWISS_POST", "description": "SWISS POST." }, { "value": "TOLL_IPEC", "description": "TOLL IPEC." }, { "value": "AIR_21", "description": "AIR 21." }, { "value": "AIRSPEED", "description": "AIRSPEED." }, { "value": "BERT", "description": "BERT." }, { "value": "BLUEDART", "description": "BLUEDART." }, { "value": "COLLECTPLUS", "description": "COLLECTPLUS." }, { "value": "COURIERPLUS", "description": "COURIERPLUS." }, { "value": "COURIER_POST", "description": "COURIER POST." }, { "value": "DHL_GLOBAL_MAIL", "description": "dhl_global_mail." }, { "value": "DPD_UK", "description": "dpd_uk." }, { "value": "DELTEC_DE", "description": "DELTEC DE." }, { "value": "DEUTSCHE_DE", "description": "deutsche_de." }, { "value": "DOTZOT", "description": "DOTZOT." }, { "value": "ELTA_GR", "description": "elta_gr." }, { "value": "EMS_CN", "description": "ems_cn." }, { "value": "ECARGO", "description": "ECARGO." }, { "value": "ENSENDA", "description": "ENSENDA." }, { "value": "FERCAM_IT", "description": "fercam_it." }, { "value": "FASTWAY_ZA", "description": "fastway_za." }, { "value": "FASTWAY_AU", "description": "fastway_au." }, { "value": "FIRST_LOGISITCS", "description": "first_logisitcs." }, { "value": "GEODIS", "description": "GEODIS." }, { "value": "GLOBEGISTICS", "description": "GLOBEGISTICS." }, { "value": "GREYHOUND", "description": "GREYHOUND." }, { "value": "JETSHIP_MY", "description": "jetship_my." }, { "value": "LION_PARCEL", "description": "LION PARCEL." }, { "value": "AEROFLASH", "description": "AEROFLASH." }, { "value": "ONTRAC", "description": "ONTRAC." }, { "value": "SAGAWA", "description": "SAGAWA." }, { "value": "SIODEMKA", "description": "SIODEMKA." }, { "value": "STARTRACK", "description": "startrack." }, { "value": "TNT_AU", "description": "tnt_au." }, { "value": "TNT_IT", "description": "tnt_it." }, { "value": "TRANSMISSION", "description": "TRANSMISSION." }, { "value": "YAMATO", "description": "YAMATO." }, { "value": "DHL_IT", "description": "dhl_it." }, { "value": "DHL_AT", "description": "dhl_at." }, { "value": "LOGISTICSWORLDWIDE_KR", "description": "LOGISTICSWORLDWIDE KR." }, { "value": "GLS_SPAIN", "description": "gls_spain." }, { "value": "AMAZON_UK_API", "description": "amazon_uk_api." }, { "value": "DPD_FR_REFERENCE", "description": "dpd_fr_reference." }, { "value": "DHLPARCEL_UK", "description": "dhlparcel_uk." }, { "value": "MEGASAVE", "description": "megasave." }, { "value": "QUALITYPOST", "description": "qualitypost." }, { "value": "IDS_LOGISTICS", "description": "ids_logistics." }, { "value": "JOYINGBOX", "description": "joyingbox." }, { "value": "PANTHER_ORDER_NUMBER", "description": "panther_order_number." }, { "value": "WATKINS_SHEPARD", "description": "watkins_shepard." }, { "value": "FASTTRACK", "description": "fasttrack." }, { "value": "UP_EXPRESS", "description": "up_express." }, { "value": "ELOGISTICA", "description": "elogistica." }, { "value": "ECOURIER", "description": "ecourier." }, { "value": "CJ_PHILIPPINES", "description": "cj_philippines." }, { "value": "SPEEDEX", "description": "speedex." }, { "value": "ORANGECONNEX", "description": "orangeconnex." }, { "value": "TECOR", "description": "tecor." }, { "value": "SAEE", "description": "saee." }, { "value": "GLS_ITALY_FTP", "description": "gls_italy_ftp." }, { "value": "DELIVERE", "description": "delivere." }, { "value": "YYCOM", "description": "yycom." }, { "value": "ADICIONAL_PT", "description": "Adicional Logistics." }, { "value": "DKSH", "description": "DKSH." }, { "value": "NIPPON_EXPRESS_FTP", "description": "Nippon Express." }, { "value": "GOLS", "description": "GO Logistics & Storage." }, { "value": "FUJEXP", "description": "FUJIE EXPRESS." }, { "value": "QTRACK", "description": "QTrack." }, { "value": "OMLOGISTICS_API", "description": "OM LOGISTICS LTD." }, { "value": "GDPHARM", "description": "GDPharm Logistics." }, { "value": "MISUMI_CN", "description": "MISUMI Group Inc.." }, { "value": "AIR_CANADA", "description": "Rivo." }, { "value": "CITY56_WEBHOOK", "description": "City Express." }, { "value": "SAGAWA_API", "description": "Sagawa." }, { "value": "KEDAEX", "description": "KedaEX." }, { "value": "PGEON_API", "description": "Pgeon." }, { "value": "WEWORLDEXPRESS", "description": "We World Express." }, { "value": "JT_LOGISTICS", "description": "J&T International logistics." }, { "value": "TRUSK", "description": "Trusk France." }, { "value": "VIAXPRESS", "description": "ViaXpress." }, { "value": "DHL_SUPPLYCHAIN_ID", "description": "DHL Supply Chain Indonesia." }, { "value": "ZUELLIGPHARMA_SFTP", "description": "Zuellig Pharma Korea." }, { "value": "MEEST", "description": "Meest." }, { "value": "TOLL_PRIORITY", "description": "Toll Priority." }, { "value": "MOTHERSHIP_API", "description": "Mothership." }, { "value": "CAPITAL", "description": "Capital Transport." }, { "value": "EUROPAKET_API", "description": "Europacket+." }, { "value": "HFD", "description": "HFD." }, { "value": "TOURLINE_REFERENCE", "description": "Tourline Express." }, { "value": "GIO_ECOURIER", "description": "GIO Express Inc." }, { "value": "CN_LOGISTICS", "description": "CN Logistics." }, { "value": "PANDION", "description": "Pandion." }, { "value": "BPOST_API", "description": "Bpost API." }, { "value": "PASSPORTSHIPPING", "description": "Passport Shipping." }, { "value": "PAKAJO", "description": "Pakajo World." }, { "value": "DACHSER", "description": "DACHSER." }, { "value": "YUSEN_SFTP", "description": "Yusen Logistics." }, { "value": "SHYPLITE", "description": "Shypmax." }, { "value": "XYY", "description": "Xingyunyi Logistics." }, { "value": "MWD", "description": "Metropolitan Warehouse & Delivery." }, { "value": "FAXECARGO", "description": "Faxe Cargo." }, { "value": "MAZET", "description": "Groupe Mazet." }, { "value": "FIRST_LOGISTICS_API", "description": "First Logistics." }, { "value": "SPRINT_PACK", "description": "SPRINT PACK." }, { "value": "HERMES_DE_FTP", "description": "Hermes Germany." }, { "value": "CONCISE", "description": "Concise." }, { "value": "KERRY_EXPRESS_TW_API", "description": "Kerry Express TaiWan." }, { "value": "EWE", "description": "EWE Global Express." }, { "value": "FASTDESPATCH", "description": "Fast Despatch Logistics Limited." }, { "value": "ABCUSTOM_SFTP", "description": "AB Custom Group." }, { "value": "CHAZKI", "description": "Chazki." }, { "value": "SHIPPIE", "description": "Shippie." }, { "value": "GEODIS_API", "description": "GEODIS - Distribution & Express." }, { "value": "NAQEL_EXPRESS", "description": "Naqel Express." }, { "value": "PAPA_WEBHOOK", "description": "Papa." }, { "value": "FORWARDAIR", "description": "Forward Air." }, { "value": "DIALOGO_LOGISTICA_API", "description": "Dialogo Logistica." }, { "value": "LALAMOVE_API", "description": "Lalamove." }, { "value": "TOMYDOOR", "description": "Tomydoor." }, { "value": "KRONOS_WEBHOOK", "description": "Kronos Express." }, { "value": "JTCARGO", "description": "J&T CARGO." }, { "value": "T_CAT", "description": "T-cat." }, { "value": "CONCISE_WEBHOOK", "description": "Concise." }, { "value": "TELEPORT_WEBHOOK", "description": "Teleport." }, { "value": "CUSTOMCO_API", "description": "The Custom Companies." }, { "value": "SPX_TH", "description": "Shopee Xpress." }, { "value": "BOLLORE_LOGISTICS", "description": "Bollore Logistics." }, { "value": "CLICKLINK_SFTP", "description": "ClickLink." }, { "value": "M3LOGISTICS", "description": "M3 Logistics." }, { "value": "VNPOST_API", "description": "Vietnam Post." }, { "value": "AXLEHIRE_FTP", "description": "Axlehire." }, { "value": "SHADOWFAX", "description": "Shadowfax." }, { "value": "MYHERMES_UK_API", "description": "EVRi." }, { "value": "DAIICHI", "description": "Daiichi Freight System Inc." }, { "value": "MENSAJEROSURBANOS_API", "description": "Mensajeros Urbanos." }, { "value": "POLARSPEED", "description": "PolarSpeed Inc." }, { "value": "IDEXPRESS_ID", "description": "iDexpress Indonesia." }, { "value": "PAYO", "description": "Payo." }, { "value": "WHISTL_SFTP", "description": "Whistl." }, { "value": "INTEX_DE", "description": "INTEX Paketdienst GmbH." }, { "value": "TRANS2U", "description": "Trans2u." }, { "value": "PRODUCTCAREGROUP_SFTP", "description": "Product Care Services Limited." }, { "value": "BIGSMART", "description": "Big Smart." }, { "value": "EXPEDITORS_API_REF", "description": "Expeditors API Reference." }, { "value": "AITWORLDWIDE_API", "description": "AIT." }, { "value": "WORLDCOURIER", "description": "World Courier." }, { "value": "QUIQUP", "description": "Quiqup." }, { "value": "AGEDISS_SFTP", "description": "Agediss." }, { "value": "ANDREANI_API", "description": "Andreani." }, { "value": "CRLEXPRESS", "description": "CRL Express." }, { "value": "SMARTCAT", "description": "SMARTCAT." }, { "value": "CROSSFLIGHT", "description": "Crossflight Limited." }, { "value": "PROCARRIER", "description": "Pro Carrier." }, { "value": "DHL_REFERENCE_API", "description": "DHL (Reference number)." }, { "value": "SEINO_API", "description": "Seino." }, { "value": "WSPEXPRESS", "description": "WSP Express." }, { "value": "KRONOS", "description": "Kronos Express." }, { "value": "TOTAL_EXPRESS_API", "description": "Total Express." }, { "value": "PARCLL", "description": "PARCLL." }, { "value": "XPEDIGO", "description": "Xpedigo." }, { "value": "STAR_TRACK_WEBHOOK", "description": "StarTrack." }, { "value": "GPOST", "description": "Georgian Post." }, { "value": "UCS", "description": "UCS." }, { "value": "DMFGROUP", "description": "DMF." }, { "value": "COORDINADORA_API", "description": "Coordinadora." }, { "value": "MARKEN", "description": "Marken." }, { "value": "NTL", "description": "NTL logistics." }, { "value": "REDJEPAKKETJE", "description": "Red je Pakketje." }, { "value": "ALLIED_EXPRESS_FTP", "description": "Allied Express (FTP)." }, { "value": "MONDIALRELAY_ES", "description": "Mondial Relay Spain(Punto Pack)." }, { "value": "NAEKO_FTP", "description": "Naeko Logistics." }, { "value": "MHI", "description": "Mhi." }, { "value": "SHIPPIFY", "description": "Shippify, Inc." }, { "value": "MALCA_AMIT_API", "description": "Malca Amit." }, { "value": "JTEXPRESS_SG_API", "description": "J&T Express Singapore." }, { "value": "DACHSER_WEB", "description": "DACHSER." }, { "value": "FLIGHTLG", "description": "Flight Logistics Group." }, { "value": "CAGO", "description": "Cago." }, { "value": "COM1EXPRESS", "description": "ComOne Express." }, { "value": "TONAMI_FTP", "description": "Tonami." }, { "value": "PACKFLEET", "description": "PACKFLEET." }, { "value": "PUROLATOR_INTERNATIONAL", "description": "Purolator International." }, { "value": "WINESHIPPING_WEBHOOK", "description": "Wineshipping." }, { "value": "DHL_ES_SFTP", "description": "DHL Spain Domestic." }, { "value": "PCHOME_API", "description": "網家速配股份有限公司." }, { "value": "CESKAPOSTA_API", "description": "Czech Post." }, { "value": "GORUSH", "description": "Go Rush." }, { "value": "HOMERUNNER", "description": "HomeRunner." }, { "value": "AMAZON_ORDER", "description": "Amazon order." }, { "value": "EFWNOW_API", "description": "Estes Forwarding Worldwide." }, { "value": "CBL_LOGISTICA_API", "description": "CBL Logistica (API)." }, { "value": "NIMBUSPOST", "description": "NimbusPost." }, { "value": "LOGWIN_LOGISTICS", "description": "Logwin Logistics." }, { "value": "NOWLOG_API", "description": "Sequoialog." }, { "value": "DPD_NL", "description": "DPD Netherlands." }, { "value": "GODEPENDABLE", "description": "Dependable Supply Chain Services." }, { "value": "ESDEX", "description": "Top Ideal Express." }, { "value": "LOGISYSTEMS_SFTP", "description": "Kiitäjät." }, { "value": "EXPEDITORS", "description": "Expeditors." }, { "value": "SNTGLOBAL_API", "description": "Snt Global Etrax." }, { "value": "SHIPX", "description": "ShipX." }, { "value": "QINTL_API", "description": "Quickstat Courier LLC." }, { "value": "PACKS", "description": "Packs." }, { "value": "POSTNL_INTERNATIONAL", "description": "PostNL International." }, { "value": "AMAZON_EMAIL_PUSH", "description": "Amazon." }, { "value": "DHL_API", "description": "DHL." }, { "value": "SPX", "description": "Shopee Express." }, { "value": "AXLEHIRE", "description": "AxleHire." }, { "value": "ICSCOURIER", "description": "ICS COURIER." }, { "value": "DIALOGO_LOGISTICA", "description": "Dialogo Logistica." }, { "value": "SHUNBANG_EXPRESS", "description": "ShunBang Express." }, { "value": "TCS_API", "description": "TCS." }, { "value": "SF_EXPRESS_CN", "description": "SF Express China." }, { "value": "PACKETA", "description": "Packeta." }, { "value": "SIC_TELIWAY", "description": "Teliway SIC Express." }, { "value": "MONDIALRELAY_FR", "description": "Mondial Relay France." }, { "value": "INTIME_FTP", "description": "InTime." }, { "value": "JD_EXPRESS", "description": "京东物流." }, { "value": "FASTBOX", "description": "Fastbox." }, { "value": "PATHEON", "description": "Patheon Logistics." }, { "value": "INDIA_POST", "description": "India Post Domestic." }, { "value": "TIPSA_REF", "description": "Tipsa Reference." }, { "value": "ECOFREIGHT", "description": "Eco Freight." }, { "value": "VOX", "description": "VOX SOLUCION EMPRESARIAL SRL." }, { "value": "DIRECTFREIGHT_AU_REF", "description": "Direct Freight Express." }, { "value": "BESTTRANSPORT_SFTP", "description": "Best Transport." }, { "value": "AUSTRALIA_POST_API", "description": "Australia Post." }, { "value": "FRAGILEPAK_SFTP", "description": "FragilePAK." }, { "value": "FLIPXP", "description": "FlipXpress." }, { "value": "VALUE_WEBHOOK", "description": "Value Logistics." }, { "value": "DAESHIN", "description": "Daeshin." }, { "value": "SHERPA", "description": "Sherpa." }, { "value": "MWD_API", "description": "Metropolitan Warehouse & Delivery." }, { "value": "SMARTKARGO", "description": "SmartKargo." }, { "value": "DNJ_EXPRESS", "description": "DNJ Express." }, { "value": "GOPEOPLE", "description": "Go People." }, { "value": "MYSENDLE_API", "description": "mySendle." }, { "value": "ARAMEX_API", "description": "Aramex." }, { "value": "PIDGE", "description": "Pidge." }, { "value": "THAIPARCELS", "description": "TP Logistic." }, { "value": "PANTHER_REFERENCE_API", "description": "Panther Reference." }, { "value": "POSTAPLUS", "description": "Posta Plus." }, { "value": "BUFFALO", "description": "BUFFALO." }, { "value": "U_ENVIOS", "description": "U-ENVIOS." }, { "value": "ELITE_CO", "description": "Elite Express." }, { "value": "ROCHE_INTERNAL_SFTP", "description": "Roche Internal Courier." }, { "value": "DBSCHENKER_ICELAND", "description": "DB Schenker Iceland." }, { "value": "TNT_FR_REFERENCE", "description": "TNT France Reference." }, { "value": "NEWGISTICSAPI", "description": "Newgistics API." }, { "value": "GLOVO", "description": "Glovo." }, { "value": "GWLOGIS_API", "description": "G.I.G." }, { "value": "SPREETAIL_API", "description": "Spreetail." }, { "value": "MOOVA", "description": "Moova." }, { "value": "PLYCONGROUP", "description": "Plycon Transportation Group." }, { "value": "USPS_WEBHOOK", "description": "USPS Informed Visibility - Webhook." }, { "value": "REIMAGINEDELIVERY", "description": "maergo." }, { "value": "EDF_FTP", "description": "Eurodifarm." }, { "value": "DAO365", "description": "DAO365." }, { "value": "BIOCAIR_FTP", "description": "BioCair." }, { "value": "RANSA_WEBHOOK", "description": "Ransa." }, { "value": "SHIPXPRES", "description": "SHIPXPRESS." }, { "value": "COURANT_PLUS_API", "description": "Courant Plus." }, { "value": "SHIPA", "description": "SHIPA." }, { "value": "HOMELOGISTICS", "description": "Home Logistics." }, { "value": "DX", "description": "DX." }, { "value": "POSTE_ITALIANE_PACCOCELERE", "description": "Poste Italiane Paccocelere." }, { "value": "TOLL_WEBHOOK", "description": "Toll Group." }, { "value": "LCTBR_API", "description": "LCT do Brasil." }, { "value": "DX_FREIGHT", "description": "DX Freight." }, { "value": "DHL_SFTP", "description": "DHL Express." }, { "value": "SHIPROCKET", "description": "Shiprocket X." }, { "value": "UBER_WEBHOOK", "description": "Uber." }, { "value": "STATOVERNIGHT", "description": "Stat Overnight." }, { "value": "BURD", "description": "Burd Delivery." }, { "value": "FASTSHIP", "description": "Fastship Express." }, { "value": "IBVENTURE_WEBHOOK", "description": "IB Venture." }, { "value": "GATI_KWE_API", "description": "Gati-KWE." }, { "value": "CRYOPDP_FTP", "description": "CryoPDP." }, { "value": "HUBBED", "description": "HUBBED." }, { "value": "TIPSA_API", "description": "Tipsa API." }, { "value": "ARASKARGO", "description": "Aras Cargo." }, { "value": "THIJS_NL", "description": "Thijs Logistiek." }, { "value": "ATSHEALTHCARE_REFERENCE", "description": "ATS Healthcare." }, { "value": "99MINUTOS", "description": "99minutos." }, { "value": "HELLENIC_POST", "description": "Hellenic (Greece) Post." }, { "value": "HSM_GLOBAL", "description": "HSM Global." }, { "value": "MNX", "description": "MNX." }, { "value": "NMTRANSFER", "description": "N&M Transfer Co., Inc.." }, { "value": "LOGYSTO", "description": "Logysto." }, { "value": "INDIA_POST_INT", "description": "India Post International." }, { "value": "AMAZON_FBA_SWISHIP_IN", "description": "Swiship IN." }, { "value": "SRT_TRANSPORT", "description": "SRT Transport." }, { "value": "BOMI", "description": "Bomi Group." }, { "value": "DELIVERR_SFTP", "description": "Deliverr." }, { "value": "HSDEXPRESS", "description": "HSDEXPRESS." }, { "value": "SIMPLETIRE_WEBHOOK", "description": "SimpleTire." }, { "value": "HUNTER_EXPRESS_SFTP", "description": "Hunter Express." }, { "value": "UPS_API", "description": "UPS." }, { "value": "WOOYOUNG_LOGISTICS_SFTP", "description": "WOO YOUNG LOGISTICS CO.,LTD.." }, { "value": "PHSE_API", "description": "PHSE." }, { "value": "WISH_EMAIL_PUSH", "description": "Wish." }, { "value": "NORTHLINE", "description": "Northline." }, { "value": "MEDAFRICA", "description": "Med Africa Logistics." }, { "value": "DPD_AT_SFTP", "description": "DPD Austria." }, { "value": "ANTERAJA", "description": "Anteraja." }, { "value": "DHL_GLOBAL_FORWARDING_API", "description": "DHL Global Forwarding API." }, { "value": "LBCEXPRESS_API", "description": "LBC EXPRESS INC.." }, { "value": "SIMSGLOBAL", "description": "Sims Global." }, { "value": "CDLDELIVERS", "description": "CDL Last Mile." }, { "value": "TYP", "description": "TYP." }, { "value": "TESTING_COURIER_WEBHOOK", "description": "Testing Courier." }, { "value": "PANDAGO_API", "description": "Pandago." }, { "value": "ROYAL_MAIL_FTP", "description": "Royal Mail." }, { "value": "THUNDEREXPRESS", "description": "Thunder Express Australia." }, { "value": "SECRETLAB_WEBHOOK", "description": "Secretlab." }, { "value": "SETEL", "description": "Setel Express." }, { "value": "JD_WORLDWIDE", "description": "JD Worldwide." }, { "value": "DPD_RU_API", "description": "DPD Russia." }, { "value": "ARGENTS_WEBHOOK", "description": "Argents Express Group." }, { "value": "POSTONE", "description": "Post ONE." }, { "value": "TUSKLOGISTICS", "description": "Tusk Logistics." }, { "value": "RHENUS_UK_API", "description": "Rhenus Logistics UK." }, { "value": "TAQBIN_SG_API", "description": "Yamato Singapore." }, { "value": "INNTRALOG_SFTP", "description": "Inntralog GmbH." }, { "value": "DAYROSS", "description": "Day & Ross." }, { "value": "CORREOSEXPRESS_API", "description": "Correos Express (API)." }, { "value": "INTERNATIONAL_SEUR_API", "description": "International Seur API." }, { "value": "YODEL_API", "description": "Yodel API." }, { "value": "HEROEXPRESS", "description": "Hero Express." }, { "value": "DHL_SUPPLYCHAIN_IN", "description": "DHL supply chain India." }, { "value": "URGENT_CARGUS", "description": "Urgent Cargus." }, { "value": "FRONTDOORCORP", "description": "FRONTdoor Collective." }, { "value": "JTEXPRESS_PH", "description": "J&T Express Philippines." }, { "value": "PARCELSTARS_WEBHOOK", "description": "Parcelstars." }, { "value": "DPD_SK_SFTP", "description": "DPD Slovakia." }, { "value": "MOVIANTO", "description": "Movianto." }, { "value": "OZEPARTS_SHIPPING", "description": "Ozeparts Shipping." }, { "value": "KARGOMKOLAY", "description": "KargomKolay (CargoMini)." }, { "value": "TRUNKRS", "description": "Trunkrs." }, { "value": "OMNIRPS_WEBHOOK", "description": "Omni Returns." }, { "value": "CHILEXPRESS", "description": "Chile Express." }, { "value": "TESTING_COURIER", "description": "Testing Courier." }, { "value": "JNE_API", "description": "JNE (API)." }, { "value": "BJSHOMEDELIVERY_FTP", "description": "BJS Distribution, Storage & Couriers - FTP." }, { "value": "DEXPRESS_WEBHOOK", "description": "D Express." }, { "value": "USPS_API", "description": "USPS API." }, { "value": "TRANSVIRTUAL", "description": "TransVirtual." }, { "value": "SOLISTICA_API", "description": "solistica." }, { "value": "CHIENVENTURE_WEBHOOK", "description": "Chienventure." }, { "value": "DPD_UK_SFTP", "description": "DPD UK." }, { "value": "INPOST_UK", "description": "InPost." }, { "value": "JAVIT", "description": "Javit." }, { "value": "ZTO_DOMESTIC", "description": "ZTO Express China." }, { "value": "DHL_GT_API", "description": "DHL Global Forwarding Guatemala." }, { "value": "CEVA_TRACKING", "description": "CEVA Package." }, { "value": "KOMON_EXPRESS", "description": "Komon Express." }, { "value": "EASTWESTCOURIER_FTP", "description": "East West Courier Pte Ltd." }, { "value": "DANNIAO", "description": "Danniao." }, { "value": "SPECTRAN", "description": "Spectran." }, { "value": "DELIVER_IT", "description": "Deliver-iT." }, { "value": "RELAISCOLIS", "description": "Relais Colis." }, { "value": "GLS_SPAIN_API", "description": "GLS Spain." }, { "value": "POSTPLUS", "description": "PostPlus." }, { "value": "AIRTERRA", "description": "Airterra." }, { "value": "GIO_ECOURIER_API", "description": "GIO Express Ecourier." }, { "value": "DPD_CH_SFTP", "description": "DPD Switzerland." }, { "value": "FEDEX_API", "description": "FedEx®." }, { "value": "INTERSMARTTRANS", "description": "INTERSMARTTRANS & SOLUTIONS SL." }, { "value": "HERMES_UK_SFTP", "description": "Hermes UK." }, { "value": "EXELOT_FTP", "description": "Exelot Ltd.." }, { "value": "DHL_PA_API", "description": "DHL GLOBAL FORWARDING PANAMÁ." }, { "value": "VIRTRANSPORT_SFTP", "description": "Vir Transport." }, { "value": "WORLDNET", "description": "Worldnet Logistics." }, { "value": "INSTABOX_WEBHOOK", "description": "Instabox." }, { "value": "KNG", "description": "Keuhne + Nagel Global." }, { "value": "FLASHEXPRESS_WEBHOOK", "description": "Flash Express." }, { "value": "MAGYAR_POSTA_API", "description": "Magyar Posta." }, { "value": "WESHIP_API", "description": "WeShip." }, { "value": "OHI_WEBHOOK", "description": "Ohi." }, { "value": "MUDITA", "description": "MUDITA." }, { "value": "BLUEDART_API", "description": "Bluedart." }, { "value": "T_CAT_API", "description": "T-cat." }, { "value": "ADS", "description": "ADS Express." }, { "value": "HERMES_IT", "description": "HR Parcel." }, { "value": "FITZMARK_API", "description": "FitzMark." }, { "value": "POSTI_API", "description": "Posti API." }, { "value": "SMSA_EXPRESS_WEBHOOK", "description": "SMSA Express." }, { "value": "TAMERGROUP_WEBHOOK", "description": "Tamer Logistics." }, { "value": "LIVRAPIDE", "description": "Livrapide." }, { "value": "NIPPON_EXPRESS", "description": "Nippon Express." }, { "value": "BETTERTRUCKS", "description": "Better Trucks." }, { "value": "FAN", "description": "FAN COURIER EXPRESS." }, { "value": "PB_USPSFLATS_FTP", "description": "USPS Flats (Pitney Bowes)." }, { "value": "PARCELRIGHT", "description": "Parcel Right." }, { "value": "ITHINKLOGISTICS", "description": "iThink Logistics." }, { "value": "KERRY_EXPRESS_TH_WEBHOOK", "description": "Kerry Logistics." }, { "value": "ECOUTIER", "description": "eCoutier." }, { "value": "SHOWL", "description": "SENHONG INTERNATIONAL LOGISTICS." }, { "value": "BRT_IT_API", "description": "BRT Bartolini API." }, { "value": "RIXONHK_API", "description": "Rixon Logistics." }, { "value": "DBSCHENKER_API", "description": "DB Schenker." }, { "value": "ILYANGLOGIS", "description": "Ilyang logistics." }, { "value": "MAIL_BOX_ETC", "description": "Mail Boxes Etc.." }, { "value": "WESHIP", "description": "WeShip." }, { "value": "DHL_GLOBAL_MAIL_API", "description": "DHL eCommerce Solutions." }, { "value": "ACTIVOS24_API", "description": "Activos24." }, { "value": "ATSHEALTHCARE", "description": "ATS Healthcare." }, { "value": "LUWJISTIK", "description": "Luwjistik." }, { "value": "GW_WORLD", "description": "Gebrüder Weiss." }, { "value": "FAIRSENDEN_API", "description": "fairsenden." }, { "value": "SERVIP_WEBHOOK", "description": "SerVIP." }, { "value": "SWISHIP", "description": "Swiship." }, { "value": "TANET", "description": "Transport Ambientales." }, { "value": "HOTSIN_CARGO", "description": "SHENZHEN HOTSIN CARGO INT'L FORWARDING CO.,LTD." }, { "value": "DIREX", "description": "Direx." }, { "value": "HUANTONG", "description": "HuanTong." }, { "value": "IMILE_API", "description": "iMile." }, { "value": "AUEXPRESS", "description": "Au Express." }, { "value": "NYTLOGISTICS", "description": "NYT SUPPLY CHAIN LOGISTICS Co.,LTD." }, { "value": "DSV_REFERENCE", "description": "DSV Futurewave." }, { "value": "NOVOFARMA_WEBHOOK", "description": "Novofarma." }, { "value": "AITWORLDWIDE_SFTP", "description": "AIT." }, { "value": "SHOPOLIVE", "description": "Olive." }, { "value": "FNF_ZA", "description": "Fast & Furious." }, { "value": "DHL_ECOMMERCE_GC", "description": "DHL eCommerce Greater China." }, { "value": "FETCHR", "description": "Fetchr." }, { "value": "STARLINKS_API", "description": "Starlinks Global." }, { "value": "YYEXPRESS", "description": "YYEXPRESS." }, { "value": "SERVIENTREGA", "description": "Servientrega." }, { "value": "HANJIN", "description": "HanJin." }, { "value": "SPANISH_SEUR_FTP", "description": "Spanish Seur." }, { "value": "DX_B2B_CONNUM", "description": "DX (B2B)." }, { "value": "HELTHJEM_API", "description": "Helthjem." }, { "value": "INEXPOST", "description": "Inexpost." }, { "value": "A2B_BA", "description": "A2B Express Logistics." }, { "value": "RHENUS_GROUP", "description": "Rhenus Logistics." }, { "value": "SBERLOGISTICS_RU", "description": "Sber Logistics." }, { "value": "MALCA_AMIT", "description": "Malca-Amit." }, { "value": "PPL", "description": "Professional Parcel Logistics." }, { "value": "OSM_WORLDWIDE_SFTP", "description": "OSM Worldwide." }, { "value": "ACILOGISTIX", "description": "ACI Logistix." }, { "value": "OPTIMACOURIER", "description": "Optima Courier." }, { "value": "NOVA_POSHTA_API", "description": "Nova Poshta API." }, { "value": "LOGGI", "description": "Loggi." }, { "value": "YIFAN", "description": "YiFan Express." }, { "value": "MYDYNALOGIC", "description": "My DynaLogic." }, { "value": "MORNINGLOBAL", "description": "Morning Global." }, { "value": "CONCISE_API", "description": "Concise." }, { "value": "FXTRAN", "description": "Falcon Express." }, { "value": "DELIVERYOURPARCEL_ZA", "description": "Deliver Your Parcel." }, { "value": "UPARCEL", "description": "uParcel." }, { "value": "MOBI_BR", "description": "Mobi Logistica." }, { "value": "LOGINEXT_WEBHOOK", "description": "T&W Delivery." }, { "value": "EMS", "description": "EMS." }, { "value": "SPEEDY", "description": "Speedy." }, { "value": "ZOOM_RED", "description": "Zoom." }, { "value": "NAVLUNGO", "description": "Navlungo." }, { "value": "CASTLEPARCELS", "description": "Castle Parcels." }, { "value": "WEEE", "description": "Weee." }, { "value": "PACKALY", "description": "Packaly." }, { "value": "YUNHUIPOST", "description": "Yunhuipost." }, { "value": "YOUPARCEL", "description": "YouParcel." }, { "value": "LEMAN", "description": "Leman." }, { "value": "MOOVIN", "description": "Moovin." }, { "value": "URB_IT", "description": "Urb-it." }, { "value": "MULTIENTREGAPANAMA", "description": "Multientrega." }, { "value": "JUSDASR", "description": "Jusdasr." }, { "value": "DISCOUNTPOST", "description": "Discount Post." }, { "value": "RHENUS_UK", "description": "Rhenus Logistics UK." }, { "value": "SWISHIP_JP", "description": "Swiship JP." }, { "value": "GLS_US", "description": "GLS USA." }, { "value": "SMTL", "description": "Southwestern Motor Transport. Inc." }, { "value": "EMEGA", "description": "Discount Post Emega." }, { "value": "EXPRESSONE_SV", "description": "EXPRESSONE Slovenia." }, { "value": "HEPSIJET", "description": "hepsiJET." }, { "value": "WELIVERY", "description": "Welivery." }, { "value": "BRINGER", "description": "Bringer Parcel Services." }, { "value": "EASYROUTES", "description": "EasyRoutes." }, { "value": "MRW", "description": "MRW." }, { "value": "RPM", "description": "RPM." }, { "value": "DPD_PRT", "description": "DPD Portugal." }, { "value": "GLS_ROMANIA", "description": "GLS Romania." }, { "value": "LMPARCEL", "description": "LM Parcel." }, { "value": "GTAGSM", "description": "GTA GSM." }, { "value": "DOMINO", "description": "DOMINO." }, { "value": "ESHIPPER", "description": "eShipper." }, { "value": "TRANSPAK", "description": "Transpak Inc.." }, { "value": "XINDUS", "description": "Xindus." }, { "value": "AOYUE", "description": "Aoyue." }, { "value": "EASYPARCEL", "description": "Easyparcel." }, { "value": "EXPRESSONE", "description": "EXPRESSONE." }, { "value": "SENDEO_KARGO", "description": "Sendeo Kargo." }, { "value": "SPEEDAF", "description": "Speedaf Express." }, { "value": "ETOWER", "description": "eTower." }, { "value": "GCX", "description": "GC Express." }, { "value": "NINJAVAN_VN", "description": "Ninjavan Vietnam." }, { "value": "ALLEGRO", "description": "Allegro." }, { "value": "JUMPPOINT", "description": "Jumppoint." }, { "value": "SHIPGLOBAL_US", "description": "ShipGlobal." }, { "value": "KINISI", "description": "Kinisi Transport Pty Ltd." }, { "value": "OAKH", "description": "Oakh Harbour Freight Lines." }, { "value": "AWEST", "description": "American West." }, { "value": "BARSAN", "description": "Barsan Global Lojistik." }, { "value": "ENERGOLOGISTIC", "description": "Energo Logistic." }, { "value": "MADROOEX", "description": "Madrooex." }, { "value": "GOBOLT", "description": "GoBolt." }, { "value": "SWISS_UNIVERSAL_EXPRESS", "description": "Swiss Universal Express." }, { "value": "IORDIRECT", "description": "IOR Direct Solutions." }, { "value": "XMSZM", "description": "xmszm." }, { "value": "GLS_HUN", "description": "GLS Hungary." }, { "value": "SENDY", "description": "Sendy Express." }, { "value": "BRAUNSEXPRESS", "description": "Brauns Express." }, { "value": "GRANDSLAMEXPRESS", "description": "Grand Slam Express." }, { "value": "XGS", "description": "XGS." }, { "value": "OTSCHILE", "description": "OTS." }, { "value": "PACK_UP", "description": "Pack-Up." }, { "value": "PARCELSTARS", "description": "Parcelstars." }, { "value": "TEAMEXPRESSLLC", "description": "Team Express Service LLC." }, { "value": "ASYADEXPRESS", "description": "Asyad Express." }, { "value": "TDN", "description": "TDN." }, { "value": "EARLYBIRD", "description": "Early Bird." }, { "value": "CACESA", "description": "Cacesa." }, { "value": "PARCELJET", "description": "Parceljet." }, { "value": "MNG_KARGO", "description": "MNG Kargo." }, { "value": "SUPERPACKLINE", "description": "Super Pac Line." }, { "value": "SPEEDX", "description": "SpeedX." }, { "value": "VESYL", "description": "Vesyl." }, { "value": "SKYKING", "description": "Sky King." }, { "value": "DIRMENSAJERIA", "description": "DIR." }, { "value": "NETLOGIXGROUP", "description": "Netlogix." }, { "value": "ZYOU", "description": "ZYEX." }, { "value": "JAWAR", "description": "Jawar." }, { "value": "AGSYSTEMS", "description": "Associate Global Systems." }, { "value": "GPS", "description": "GPS." }, { "value": "PTT_KARGO", "description": "PTT Kargo." }, { "value": "MAERGO", "description": "Maergo." }, { "value": "ARIHANTCOURIER", "description": "AICS." }, { "value": "VTFE", "description": "VicTas Freight Express." }, { "value": "YUNANT", "description": "Yunant." }, { "value": "URBIFY", "description": "Urbify." }, { "value": "PACK_MAN", "description": "pack-man." }, { "value": "LIEFERGRUN", "description": "LIEFERGRUN." }, { "value": "OBIBOX", "description": "Obibox." }, { "value": "PAIKEDA", "description": "Paikeda." }, { "value": "SCOTTY", "description": "Scotty." }, { "value": "INTELCOM_CA", "description": "Intelcom." }, { "value": "SWE", "description": "swe." }, { "value": "ASENDIA", "description": "Asendia Global." }, { "value": "DPD_AT", "description": "DPD Austria." }, { "value": "RELAY", "description": "Relay." }, { "value": "ATA", "description": "ATA." }, { "value": "SKYEXPRESS_INTERNATIONAL", "description": "SkyExpress Internationals." }, { "value": "SURAT_KARGO", "description": "Surat Kargo." }, { "value": "SGLINK", "description": "SG LINK." }, { "value": "FLEETOPTICSINC", "description": "FleetOptics." }, { "value": "SHOPLINE", "description": "shopline." }, { "value": "PIGGYSHIP", "description": "PIGGYSHIP." }, { "value": "LOGOIX", "description": "LogoiX." }, { "value": "KOLAY_GELSIN", "description": "Kolay Gelsin." }, { "value": "ASSOCIATED_COURIERS", "description": "Associated Couriers." }, { "value": "UPS_CHECKER", "description": "ups-checker." }, { "value": "WINESHIPPING", "description": "Wineshipping." }, { "value": "SPEDISCI", "description": "Spedisci online." } ], "enum": [ "DPD_RU", "BG_BULGARIAN_POST", "KR_KOREA_POST", "ZA_COURIERIT", "FR_EXAPAQ", "ARE_EMIRATES_POST", "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", "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", "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", "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", "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", "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", "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", "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", "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", "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", "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", "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", "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", "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", "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", "FASTWAY_UK", "FASTWAY_US", "GLS_DE", "GLS_ES", "GLS_FR", "MONDIAL_BE", "SGT_IT", "TNT_CN", "TNT_DE", "TNT_ES", "TNT_PL", "PARCELFORCE", "SWISS_POST", "TOLL_IPEC", "AIR_21", "AIRSPEED", "BERT", "BLUEDART", "COLLECTPLUS", "COURIERPLUS", "COURIER_POST", "DHL_GLOBAL_MAIL", "DPD_UK", "DELTEC_DE", "DEUTSCHE_DE", "DOTZOT", "ELTA_GR", "EMS_CN", "ECARGO", "ENSENDA", "FERCAM_IT", "FASTWAY_ZA", "FASTWAY_AU", "FIRST_LOGISITCS", "GEODIS", "GLOBEGISTICS", "GREYHOUND", "JETSHIP_MY", "LION_PARCEL", "AEROFLASH", "ONTRAC", "SAGAWA", "SIODEMKA", "STARTRACK", "TNT_AU", "TNT_IT", "TRANSMISSION", "YAMATO", "DHL_IT", "DHL_AT", "LOGISTICSWORLDWIDE_KR", "GLS_SPAIN", "AMAZON_UK_API", "DPD_FR_REFERENCE", "DHLPARCEL_UK", "MEGASAVE", "QUALITYPOST", "IDS_LOGISTICS", "JOYINGBOX", "PANTHER_ORDER_NUMBER", "WATKINS_SHEPARD", "FASTTRACK", "UP_EXPRESS", "ELOGISTICA", "ECOURIER", "CJ_PHILIPPINES", "SPEEDEX", "ORANGECONNEX", "TECOR", "SAEE", "GLS_ITALY_FTP", "DELIVERE", "YYCOM", "ADICIONAL_PT", "DKSH", "NIPPON_EXPRESS_FTP", "GOLS", "FUJEXP", "QTRACK", "OMLOGISTICS_API", "GDPHARM", "MISUMI_CN", "AIR_CANADA", "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", "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", "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", "DAIICHI", "MENSAJEROSURBANOS_API", "POLARSPEED", "IDEXPRESS_ID", "PAYO", "WHISTL_SFTP", "INTEX_DE", "TRANS2U", "PRODUCTCAREGROUP_SFTP", "BIGSMART", "EXPEDITORS_API_REF", "AITWORLDWIDE_API", "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", "DMFGROUP", "COORDINADORA_API", "MARKEN", "NTL", "REDJEPAKKETJE", "ALLIED_EXPRESS_FTP", "MONDIALRELAY_ES", "NAEKO_FTP", "MHI", "SHIPPIFY", "MALCA_AMIT_API", "JTEXPRESS_SG_API", "DACHSER_WEB", "FLIGHTLG", "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", "SPX", "AXLEHIRE", "ICSCOURIER", "DIALOGO_LOGISTICA", "SHUNBANG_EXPRESS", "TCS_API", "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", "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", "POSTE_ITALIANE_PACCOCELERE", "TOLL_WEBHOOK", "LCTBR_API", "DX_FREIGHT", "DHL_SFTP", "SHIPROCKET", "UBER_WEBHOOK", "STATOVERNIGHT", "BURD", "FASTSHIP", "IBVENTURE_WEBHOOK", "GATI_KWE_API", "CRYOPDP_FTP", "HUBBED", "TIPSA_API", "ARASKARGO", "THIJS_NL", "ATSHEALTHCARE_REFERENCE", "99MINUTOS", "HELLENIC_POST", "HSM_GLOBAL", "MNX", "NMTRANSFER", "LOGYSTO", "INDIA_POST_INT", "AMAZON_FBA_SWISHIP_IN", "SRT_TRANSPORT", "BOMI", "DELIVERR_SFTP", "HSDEXPRESS", "SIMPLETIRE_WEBHOOK", "HUNTER_EXPRESS_SFTP", "UPS_API", "WOOYOUNG_LOGISTICS_SFTP", "PHSE_API", "WISH_EMAIL_PUSH", "NORTHLINE", "MEDAFRICA", "DPD_AT_SFTP", "ANTERAJA", "DHL_GLOBAL_FORWARDING_API", "LBCEXPRESS_API", "SIMSGLOBAL", "CDLDELIVERS", "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", "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", "AUEXPRESS", "NYTLOGISTICS", "DSV_REFERENCE", "NOVOFARMA_WEBHOOK", "AITWORLDWIDE_SFTP", "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", "SPEEDY", "ZOOM_RED", "NAVLUNGO", "CASTLEPARCELS", "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", "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", "OTSCHILE", "PACK_UP", "PARCELSTARS", "TEAMEXPRESSLLC", "ASYADEXPRESS", "TDN", "EARLYBIRD", "CACESA", "PARCELJET", "MNG_KARGO", "SUPERPACKLINE", "SPEEDX", "VESYL", "SKYKING", "DIRMENSAJERIA", "NETLOGIXGROUP", "ZYOU", "JAWAR", "AGSYSTEMS", "GPS", "PTT_KARGO", "MAERGO", "ARIHANTCOURIER", "VTFE", "YUNANT", "URBIFY", "PACK_MAN", "LIEFERGRUN", "OBIBOX", "PAIKEDA", "SCOTTY", "INTELCOM_CA", "SWE", "ASENDIA", "DPD_AT", "RELAY", "ATA", "SKYEXPRESS_INTERNATIONAL", "SURAT_KARGO", "SGLINK", "FLEETOPTICSINC", "SHOPLINE", "PIGGYSHIP", "LOGOIX", "KOLAY_GELSIN", "ASSOCIATED_COURIERS", "UPS_CHECKER", "WINESHIPPING", "SPEDISCI" ] }, "shipping_detail": { "type": "object", "description": "The shipping details.", "title": "Shipping Details", "properties": { "name": { "description": "The name of the party.", "type": "object", "title": "Name", "properties": { "full_name": { "type": "string", "description": "When the party is a person, the party's full name.", "maxLength": 300 } } }, "email_address": { "description": "The email address of the recipient of the shipped items, which may belong to either the payer, or an alternate contact, for delivery.", "$ref": "#/components/schemas/email_address" }, "phone_number": { "description": "The phone number, in its canonical international [E.164 numbering plan format](https://www.itu.int/rec/T-REC-E.164/en).", "type": "object", "title": "Phone", "properties": { "country_code": { "type": "string", "description": "The country calling code (CC), in its canonical international [E.164 numbering plan format](https://www.itu.int/rec/T-REC-E.164/en). 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).", "minLength": 1, "maxLength": 3, "pattern": "^[0-9]{1,3}?$" }, "national_number": { "type": "string", "description": "The national number, in its canonical international [E.164 numbering plan format](https://www.itu.int/rec/T-REC-E.164/en). 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).", "minLength": 1, "maxLength": 14, "pattern": "^[0-9]{1,14}?$" } }, "required": ["country_code", "national_number"] }, "type": { "title": "Fulfillment Type", "description": "A classification for the method of purchase fulfillment (e.g shipping, in-store pickup, etc). Either `type` or `options` may be present, but not both.", "type": "string", "minLength": 1, "maxLength": 255, "pattern": "^[0-9A-Z_]+$", "x-enumDescriptions": [ { "value": "SHIPPING", "description": "The payer intends to receive the items at a specified address.", "default": true }, { "value": "PICKUP_IN_PERSON", "description": "DEPRECATED. Please use \"PICKUP_FROM_PERSON\" instead." }, { "value": "PICKUP_IN_STORE", "description": "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." }, { "value": "PICKUP_FROM_PERSON", "description": "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." } ], "enum": [ "SHIPPING", "PICKUP_IN_PERSON", "PICKUP_IN_STORE", "PICKUP_FROM_PERSON" ] }, "options": { "$ref": "#/components/schemas/shipping_option_list" }, "address": { "description": "The portable international postal address. Maps to [AddressValidationMetadata](https://github.com/googlei18n/libaddressinput/wiki/AddressValidationMetadata) and HTML 5.1 [Autofilling form controls: the autocomplete attribute](https://www.w3.org/TR/html51/sec-forms.html#autofilling-form-controls-the-autocomplete-attribute).", "type": "object", "title": "Portable Postal Address (Medium-Grained)", "properties": { "address_line_1": { "type": "string", "description": "The first line of the address, such as number and street, for example, `173 Drury Lane`. Needed for data entry, and Compliance and Risk checks. This field needs to pass the full address.", "maxLength": 300 }, "address_line_2": { "type": "string", "description": "The second line of the address, for example, a suite or apartment number.", "maxLength": 300 }, "admin_area_2": { "type": "string", "description": "A city, town, or village. Smaller than `admin_area_level_1`.", "maxLength": 120 }, "admin_area_1": { "type": "string", "description": "The highest-level sub-division in a country, which is usually a province, state, or ISO-3166-2 subdivision. This data is formatted for postal delivery, for example, `CA` and not `California`. Value, by country, is:", "maxLength": 300 }, "postal_code": { "type": "string", "description": "The postal code, which is the ZIP code or equivalent. Typically required for countries with a postal code or an equivalent. See [postal code](https://en.wikipedia.org/wiki/Postal_code).", "maxLength": 60 }, "country_code": { "$ref": "#/components/schemas/country_code" } }, "required": ["country_code"] } } }, "shipping_option": { "type": "object", "title": "Shipping Option", "description": "The options that the payee or merchant offers to the payer to ship or pick up their items.", "properties": { "id": { "type": "string", "description": "A unique ID that identifies a payer-selected shipping option.", "maxLength": 127 }, "label": { "type": "string", "description": "A description that the payer sees, which helps them choose an appropriate shipping option. For example, `Free Shipping`, `USPS Priority Shipping`, `Expédition prioritaire USPS`, or `USPS yōuxiān fā huò`. Localize this description to the payer's locale.", "maxLength": 127 }, "type": { "description": "A classification for the method of purchase fulfillment.", "$ref": "#/components/schemas/shipping_type" }, "amount": { "description": "The shipping cost for the selected option.", "$ref": "#/components/schemas/money" }, "selected": { "type": "boolean", "description": "If the API request sets `selected = true`, it represents the shipping option that the payee or merchant expects to be pre-selected for the payer when they first view the `shipping.options` in the PayPal Checkout experience. As part of the response if a `shipping.option` contains `selected=true`, it represents the shipping option that the payer selected during the course of checkout with PayPal. Only one `shipping.option` can be set to `selected=true`." } }, "required": ["id", "label", "selected"] }, "shipping_option_list": { "type": "array", "description": "An array of shipping options that the payee or merchant offers to the payer to ship or pick up their items.", "minItems": 0, "maxItems": 10, "items": { "$ref": "#/components/schemas/shipping_option" } }, "shipping_options_purchase_unit": { "type": "object", "title": "Shipping Option and Amount data at Purchase Unit", "description": "This would contain shipping option and amount data at purchase unit level.", "properties": { "reference_id": { "type": "string", "description": "The API caller-provided external ID for the purchase unit. Required for multiple purchase units when you must update the order through `PATCH`. If you omit this value and the order contains only one purchase unit, PayPal sets this value to `default`.
Note: If there are multiple purchase units, reference_id is required for each purchase unit.
", "minLength": 1, "maxLength": 256, "pattern": "^.*$" }, "amount": { "description": "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.", "$ref": "#/components/schemas/amount_with_breakdown" }, "shipping_options": { "$ref": "#/components/schemas/definitions-shipping_option_list" } } }, "shipping_type": { "type": "string", "title": "Shipping Type", "description": "A classification for the method of purchase fulfillment.", "x-enumDescriptions": [ { "value": "SHIPPING", "description": "The payer intends to receive the items at a specified address.", "default": true }, { "value": "PICKUP", "description": "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). " }, { "value": "PICKUP_IN_STORE", "description": "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." }, { "value": "PICKUP_FROM_PERSON", "description": "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." } ], "enum": ["SHIPPING", "PICKUP", "PICKUP_IN_STORE", "PICKUP_FROM_PERSON"] }, "shipping_with_tracking_details": { "type": "object", "title": "Shipping With Tracking Details", "description": "The order shipping details.", "allOf": [ { "$ref": "#/components/schemas/shipping_detail" }, { "properties": { "trackers": { "$ref": "#/components/schemas/tracker_list" } } } ] }, "single_use_token": { "type": "string", "description": "The PayPal-generated, short-lived, one-time-use token, used to communicate payment information to PayPal for transaction processing.", "minLength": 1, "maxLength": 255, "pattern": "^[0-9a-zA-Z_-]+$" }, "sofort": { "type": "object", "title": "Sofort payment object", "description": "Information used to pay using Sofort.", "properties": { "name": { "description": "The name of the account holder associated with this payment method.", "$ref": "#/components/schemas/full_name" }, "country_code": { "description": "The two-character ISO 3166-1 country code.", "$ref": "#/components/schemas/country_code-2" }, "bic": { "description": "The bank identification code (BIC).", "$ref": "#/components/schemas/bic" }, "iban_last_chars": { "$ref": "#/components/schemas/iban_last_chars" } } }, "sofort_request": { "type": "object", "title": "Sofort payment request", "description": "Information needed to pay using Sofort.", "properties": { "name": { "description": "The name of the account holder associated with this payment method.", "$ref": "#/components/schemas/full_name" }, "country_code": { "description": "The two-character ISO 3166-1 country code.", "$ref": "#/components/schemas/country_code-2" }, "experience_context": { "description": "Customizes the payer experience during the approval process for the payment.", "$ref": "#/components/schemas/experience_context_base" } }, "required": ["name", "country_code"] }, "store_in_vault_instruction": { "type": "string", "description": "Defines how and when the payment source gets vaulted.", "minLength": 1, "maxLength": 255, "pattern": "^[0-9A-Z_]+$", "x-enumDescriptions": [ { "value": "ON_SUCCESS", "description": "Defines that the payment_source will be vaulted only when at least one authorization or capture using that payment_source is successful." } ], "enum": ["ON_SUCCESS"] }, "stored_payment_source": { "type": "object", "title": "Stored Payment Source", "description": "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:
", "properties": { "payment_initiator": { "$ref": "#/components/schemas/payment_initiator" }, "payment_type": { "$ref": "#/components/schemas/stored_payment_source_payment_type" }, "usage": { "$ref": "#/components/schemas/stored_payment_source_usage_type" }, "previous_network_transaction_reference": { "$ref": "#/components/schemas/network_transaction_reference" } }, "required": ["payment_initiator", "payment_type"] }, "stored_payment_source_payment_type": { "type": "string", "minLength": 1, "maxLength": 255, "pattern": "^[0-9A-Z_]+$", "description": "Indicates the type of the stored payment_source payment.", "x-enumDescriptions": [ { "value": "ONE_TIME", "description": "One Time payment such as online purchase or donation. (e.g. Checkout with one-click)." }, { "value": "RECURRING", "description": "Payment which is part of a series of payments with fixed or variable amounts, following a fixed time interval. (e.g. Subscription payments)." }, { "value": "UNSCHEDULED", "description": "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)." } ], "enum": ["ONE_TIME", "RECURRING", "UNSCHEDULED"] }, "stored_payment_source_usage_type": { "type": "string", "minLength": 1, "maxLength": 255, "pattern": "^[0-9A-Z_]+$", "default": "DERIVED", "description": "Indicates if this is a `first` or `subsequent` payment using a stored payment source (also referred to as stored credential or card on file).", "x-enumDescriptions": [ { "value": "FIRST", "description": "Indicates the Initial/First payment with a payment_source that is intended to be stored upon successful processing of the payment." }, { "value": "SUBSEQUENT", "description": "Indicates a payment using a stored payment_source which has been successfully used previously for a payment." }, { "value": "DERIVED", "description": "Indicates that PayPal will derive the value of `FIRST` or `SUBSEQUENT` based on data available to PayPal." } ], "enum": ["FIRST", "SUBSEQUENT", "DERIVED"] }, "supplementary_data": { "title": "Supplementary Data", "type": "object", "description": "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.", "properties": { "card": { "description": "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.", "$ref": "#/components/schemas/card_supplementary_data" }, "risk": { "description": "Merchants and partners can add additional customer parameters that can help with better fraud protection and reduced risk for unbranded card payments.", "$ref": "#/components/schemas/risk_supplementary_data" } } }, "swish": { "type": "object", "title": "swish payment object", "description": "Information used to pay using swish.", "properties": { "name": { "description": "The name of the account holder associated with this payment method.", "$ref": "#/components/schemas/full_name" }, "country_code": { "description": "The two-character ISO 3166-1 country code.", "$ref": "#/components/schemas/country_code-2" }, "qr_data": { "description": "QR data received from APM processor, The pattern is not provided because the value is defined by an external party.", "type": "string", "minLength": 50, "maxLength": 520, "pattern": "^.*$" }, "qr_image": { "description": "QR image received from APM processor, The pattern is not provided because the value is defined by an external party.", "type": "string", "minLength": 75, "maxLength": 80, "pattern": "^.*$", "x-security-classification": { "data_class": "class4", "data_category": "INTRINSIC" } }, "intent_url": { "description": "The URL to open the Swish app.", "type": "string", "format": "uri" } } }, "swish_request": { "type": "object", "title": "Payment request for Swish", "description": "Information needed to pay using Swish.", "properties": { "name": { "description": "The name of the account holder associated with this payment method.", "$ref": "#/components/schemas/full_name" }, "country_code": { "description": "The two-character ISO 3166-1 country code.", "$ref": "#/components/schemas/country_code-2" }, "experience_context": { "description": "Customizes the payer experience during the approval process for the payment.", "$ref": "#/components/schemas/experience_context_swish" } }, "required": ["name", "country_code"] }, "tax_info": { "type": "object", "description": "The tax ID of the customer. The customer is also known as the payer. Both `tax_id` and `tax_id_type` are required.", "title": "Tax Info", "properties": { "tax_id": { "type": "string", "description": "The customer's tax ID value.", "minLength": 1, "maxLength": 14, "pattern": "([a-zA-Z0-9])" }, "tax_id_type": { "type": "string", "description": "The customer's tax ID type.", "minLength": 1, "maxLength": 14, "pattern": "^[A-Z0-9_]+$", "x-enumDescriptions": [ { "value": "BR_CPF", "description": "The individual tax ID type, typically is 11 characters long." }, { "value": "BR_CNPJ", "description": "The business tax ID type, typically is 14 characters long." } ], "enum": ["BR_CPF", "BR_CNPJ"] } }, "required": ["tax_id", "tax_id_type"] }, "three_d_secure_authentication_response": { "type": "object", "title": "Response of 3D Secure Authentication", "description": "Results of 3D Secure Authentication.", "properties": { "authentication_status": { "description": "The outcome of the issuer's authentication.", "$ref": "#/components/schemas/pares_status" }, "enrollment_status": { "description": "Status of authentication eligibility.", "$ref": "#/components/schemas/enrolled" } } }, "token": { "type": "object", "title": "Token", "description": "The tokenized payment source to fund a payment.", "properties": { "id": { "type": "string", "description": "The PayPal-generated ID for the token.", "pattern": "^[0-9a-zA-Z_-]+$", "minLength": 1, "maxLength": 255 }, "type": { "type": "string", "description": "The tokenization method that generated the ID.", "minLength": 1, "maxLength": 255, "pattern": "^[0-9A-Z_-]+$", "x-enumDescriptions": [ { "value": "BILLING_AGREEMENT", "description": "The PayPal billing agreement ID. References an approved recurring payment for goods or services." } ], "enum": ["BILLING_AGREEMENT"] } }, "required": ["id", "type"] }, "tracker": { "type": "object", "title": "Order Tracker Response.", "description": "The tracking response on creation of tracker.", "allOf": [ { "properties": { "id": { "type": "string", "description": "The tracker id.", "readOnly": true }, "status": { "$ref": "#/components/schemas/tracker_status" }, "items": { "$ref": "#/components/schemas/tracker_item_list" }, "links": { "$ref": "#/components/schemas/definitions-link_description_list" } } }, { "$ref": "#/components/schemas/activity_timestamps" } ] }, "tracker_item": { "type": "object", "title": "Tracker Item", "description": "The details of the items in the shipment.", "properties": { "name": { "type": "string", "description": "The item name or title.", "minLength": 1, "maxLength": 127 }, "quantity": { "type": "string", "description": "The item quantity. Must be a whole number.", "minLength": 1, "maxLength": 10, "pattern": "^[1-9][0-9]{0,9}$" }, "sku": { "type": "string", "description": "The stock keeping unit (SKU) for the item. This can contain unicode characters.", "minLength": 1, "maxLength": 127 }, "url": { "type": "string", "format": "uri", "minLength": 1, "maxLength": 2048, "description": "The URL to the item being purchased. Visible to buyer and used in buyer experiences." }, "image_url": { "type": "string", "format": "uri", "description": "The URL of the item's image. File type and size restrictions apply. An image that violates these restrictions will not be honored.", "minLength": 1, "maxLength": 2048, "pattern": "^(https:)([/|.|\\w|\\s|-])*\\.(?:jpg|gif|png|jpeg|JPG|GIF|PNG|JPEG)" }, "upc": { "description": "The Universal Product Code of the item.", "$ref": "#/components/schemas/universal_product_code" } } }, "tracker_item_list": { "type": "array", "description": "An array of details of items in the shipment.", "items": { "$ref": "#/components/schemas/tracker_item" } }, "tracker_list": { "type": "array", "description": "An array of trackers for a transaction.", "items": { "$ref": "#/components/schemas/tracker" } }, "tracker_status": { "type": "string", "title": "Tracker Status", "description": "The status of the item shipment.", "minLength": 1, "maxLength": 64, "pattern": "^[0-9A-Z_]+$", "x-enumDescriptions": [ { "value": "CANCELLED", "description": "The shipment was cancelled and the tracking number no longer applies." }, { "value": "SHIPPED", "description": "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." } ], "enum": ["CANCELLED", "SHIPPED"] }, "trustly": { "type": "object", "title": "Trustly payment object", "description": "Information needed to pay using Trustly.", "properties": { "name": { "description": "The name of the account holder associated with this payment method.", "$ref": "#/components/schemas/full_name" }, "country_code": { "description": "The two-character ISO 3166-1 country code.", "$ref": "#/components/schemas/country_code-2" }, "email": { "description": "The email address of the account holder associated with this payment method.", "$ref": "#/components/schemas/email_address" }, "bic": { "description": "The bank identification code (BIC).", "$ref": "#/components/schemas/bic" }, "iban_last_chars": { "$ref": "#/components/schemas/iban_last_chars" } } }, "trustly_request": { "type": "object", "title": "Trustly payment request", "description": "Information needed to pay using Trustly.", "properties": { "name": { "description": "The name of the account holder associated with this payment method.", "$ref": "#/components/schemas/full_name" }, "country_code": { "description": "The two-character ISO 3166-1 country code.", "$ref": "#/components/schemas/country_code-2" }, "email": { "description": "The email address of the account holder associated with this payment method.", "$ref": "#/components/schemas/email_address" }, "experience_context": { "description": "Customizes the payer experience during the approval process for the payment.", "$ref": "#/components/schemas/experience_context_base" } }, "required": ["name", "country_code", "email"] }, "universal_product_code": { "type": "object", "title": "Universal Product Code", "description": "The Universal Product Code of the item.", "properties": { "type": { "title": "Universal Product Code Type", "type": "string", "x-enumDescriptions": [ { "value": "UPC-A" }, { "value": "UPC-B" }, { "value": "UPC-C" }, { "value": "UPC-D" }, { "value": "UPC-E" }, { "value": "UPC-2" }, { "value": "UPC-5" } ], "description": "The Universal Product Code type.", "minLength": 1, "maxLength": 5, "pattern": "^[0-9A-Z_-]+$", "enum": [ "UPC-A", "UPC-B", "UPC-C", "UPC-D", "UPC-E", "UPC-2", "UPC-5" ] }, "code": { "type": "string", "description": "The UPC product code of the item.", "minLength": 6, "maxLength": 17, "pattern": "^[0-9]{0,17}$" } }, "required": ["type", "code"] }, "url": { "type": "string", "description": "Describes the URL.", "format": "uri" }, "v3_vault_instruction_base": { "type": "object", "title": "Base Vault Instruction Parameters", "description": "Base vaulting specification. The object can be extended for specific use cases within each payment_source that supports vaulting.", "properties": { "store_in_vault": { "$ref": "#/components/schemas/store_in_vault_instruction" } }, "required": ["store_in_vault"] }, "vault_id": { "type": "string", "description": "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.", "minLength": 1, "maxLength": 255, "pattern": "^[0-9a-zA-Z_-]+$" }, "vault_instruction_base": { "type": "object", "title": "Vault Instruction Base", "description": "Basic vault instruction specification that can be extended by specific payment sources that supports vaulting.", "properties": { "store_in_vault": { "$ref": "#/components/schemas/store_in_vault_instruction" } } }, "vault_response": { "type": "object", "title": "Vault Response", "description": "The details about a saved payment source.", "properties": { "id": { "type": "string", "description": "The PayPal-generated ID for the saved payment source.", "minLength": 1, "maxLength": 255 }, "status": { "title": "Vault Status", "type": "string", "description": "The vault status.", "minLength": 1, "maxLength": 255, "pattern": "^[0-9A-Z_]+$", "x-enumDescriptions": [ { "value": "VAULTED", "description": "The payment source has been saved in your customer's vault. This vault status reflects `/v3/vault` status." }, { "value": "CREATED", "description": "DEPRECATED. The payment source has been saved in your customer's vault. This status applies to deprecated integration patterns and will not be returned for v3/vault integrations." }, { "value": "APPROVED", "description": "Customer has approved the action of saving the specified payment_source into their vault. Use v3/vault/payment-tokens with given setup_token to save the payment source in the vault" } ], "deprecated": true, "enum": ["VAULTED", "CREATED", "APPROVED"] }, "customer": { "type": "object", "title": "Customer Information", "description": "This object represents a merchant’s customer, allowing them to store contact details, and track all payments associated with the same customer.", "properties": { "id": { "$ref": "#/components/schemas/merchant_partner_customer_id" }, "name": { "description": "The name of the party.", "type": "object", "title": "Name", "properties": { "given_name": { "type": "string", "description": "When the party is a person, the party's given, or first, name.", "maxLength": 140 }, "surname": { "type": "string", "description": "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.", "maxLength": 140 } } } } }, "links": { "$ref": "#/components/schemas/link_description_list" } } }, "vault_venmo_wallet_base": { "type": "object", "title": "Vaulted Venmo Wallet Common Attributes", "description": "Resource consolidating common request and response attirbutes for vaulting Venmo Wallet.", "allOf": [ { "$ref": "#/components/schemas/v3_vault_instruction_base" }, { "properties": { "description": { "type": "string", "description": "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.", "minLength": 1, "maxLength": 128, "pattern": "^[a-zA-Z0-9_'\\-., :;\\!?\"]*$" }, "usage_pattern": { "title": "Venmo Payment Token Usage Pattern", "type": "string", "description": "Expected business/pricing model for the billing agreement.", "minLength": 1, "maxLength": 30, "pattern": "^[0-9A-Z_]+$", "x-enumDescriptions": [ { "value": "IMMEDIATE", "description": "On-demand instant payments – non-recurring, pre-paid, variable amount, variable frequency." }, { "value": "DEFERRED", "description": "Pay after use, non-recurring post-paid, variable amount, irregular frequency." }, { "value": "RECURRING_PREPAID", "description": "Pay upfront fixed or variable amount on a fixed date before the goods/service is delivered." }, { "value": "RECURRING_POSTPAID", "description": "Pay on a fixed date based on usage or consumption after the goods/service is delivered." }, { "value": "THRESHOLD_PREPAID", "description": "Charge payer when the set amount is reached or monthly billing cycle, whichever comes first, before the goods/service is delivered." }, { "value": "THRESHOLD_POSTPAID", "description": "Charge payer when the set amount is reached or monthly billing cycle, whichever comes first, after the goods/service is delivered." } ], "enum": [ "IMMEDIATE", "DEFERRED", "RECURRING_PREPAID", "RECURRING_POSTPAID", "THRESHOLD_PREPAID", "THRESHOLD_POSTPAID" ] }, "usage_type": { "title": "Venmo Payment Token Usage Type", "type": "string", "description": "The usage type associated with the Venmo payment token.", "minLength": 1, "maxLength": 255, "pattern": "^[0-9A-Z_]+$", "x-enumDescriptions": [ { "value": "MERCHANT", "description": "The Venmo Payment Token will be used for future transaction directly with a merchant." }, { "value": "PLATFORM", "description": "The Venmo Payment Token will be used for future transaction on a platform. A platform is typically a marketplace or a channel that a payer can purchase goods and services from multiple merchants." } ], "enum": ["MERCHANT", "PLATFORM"] }, "customer_type": { "title": "Venmo Payment Token Customer Type", "type": "string", "description": "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.", "minLength": 1, "maxLength": 255, "pattern": "^[0-9A-Z_]+$", "default": "CONSUMER", "x-enumDescriptions": [ { "value": "CONSUMER", "description": "The customer vaulting the Venmo payment token is a consumer on the merchant / platform." }, { "value": "BUSINESS", "description": "The customer vaulting the Venmo payment token is a business on merchant / platform." } ], "enum": ["CONSUMER", "BUSINESS"] }, "permit_multiple_payment_tokens": { "type": "boolean", "description": "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.", "default": false } } } ], "required": ["usage_type"] }, "venmo_wallet_attributes": { "type": "object", "title": "Venmo Wallet Attributes", "description": "Additional attributes associated with the use of this Venmo Wallet.", "properties": { "customer": { "$ref": "#/components/schemas/customer" }, "vault": { "description": "Attributes used to provide the instructions during vaulting of the Venmo Wallet.", "$ref": "#/components/schemas/vault_venmo_wallet_base" } } }, "venmo_wallet_attributes_response": { "type": "object", "title": "Venmo Wallet Attributes Response", "description": "Additional attributes associated with the use of a Venmo Wallet.", "properties": { "vault": { "$ref": "#/components/schemas/vault_response" } } }, "venmo_wallet_experience_context": { "type": "object", "title": "Venmo Wallet Experience Context", "description": "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.
", "properties": { "brand_name": { "type": "string", "description": "The business name of the merchant. The pattern is defined by an external party and supports Unicode.", "minLength": 1, "maxLength": 127, "pattern": "^.*$" }, "shipping_preference": { "type": "string", "description": "The location from which the shipping address is derived.", "minLength": 1, "maxLength": 24, "pattern": "^[A-Z_]+$", "default": "GET_FROM_FILE", "x-enumDescriptions": [ { "value": "GET_FROM_FILE", "description": "Get the customer-provided shipping address on the PayPal site." }, { "value": "NO_SHIPPING", "description": "Redacts the shipping address from the PayPal site. Recommended for digital goods." }, { "value": "SET_PROVIDED_ADDRESS", "description": "Get the merchant-provided address. The customer cannot change this address on the PayPal site. If merchant does not pass an address, customer can choose the address on PayPal pages." } ], "enum": ["GET_FROM_FILE", "NO_SHIPPING", "SET_PROVIDED_ADDRESS"] }, "order_update_callback_config": { "description": "Merchant provided Order Update callback configuration for Venmo Wallet.Venmo will call back merchant when the specified event occurs.we recommend merchants to pass both the shipping_options and shipping_address callback events. Not supported when `shipping.type` is specified or when 'application_context.shipping_preference' is set as 'NO_SHIPPING' or 'SET_PROVIDED_ADDRESS'.", "$ref": "#/components/schemas/callback_configuration" } } }, "venmo_wallet_request": { "type": "object", "title": "Venmo Wallet Request", "description": "Information needed to pay using Venmo.", "properties": { "vault_id": { "description": "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.", "$ref": "#/components/schemas/vault_id" }, "email_address": { "description": "The email address of the payer.", "$ref": "#/components/schemas/email" }, "experience_context": { "$ref": "#/components/schemas/venmo_wallet_experience_context" }, "attributes": { "description": "Additional attributes associated with the use of this wallet.", "$ref": "#/components/schemas/venmo_wallet_attributes" } } }, "venmo_wallet_response": { "type": "object", "title": "Venmo Wallet Response", "description": "Venmo wallet response.", "properties": { "email_address": { "description": "The email address of the payer.", "$ref": "#/components/schemas/email" }, "account_id": { "description": "This is an immutable system-generated id for a user's Venmo account.", "readOnly": true, "$ref": "#/components/schemas/account_id-2" }, "user_name": { "description": "The Venmo user name chosen by the user, also know as a Venmo handle.", "type": "string", "pattern": "^[-a-zA-Z0-9_]*$", "minLength": 1, "maxLength": 50 }, "name": { "description": "The name of the party.", "type": "object", "title": "Name", "properties": { "given_name": { "type": "string", "description": "When the party is a person, the party's given, or first, name.", "maxLength": 140 }, "surname": { "type": "string", "description": "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.", "maxLength": 140 } } }, "phone_number": { "description": "The phone number associated with the Venmo account, in its canonical international [E.164 numbering plan format](https://www.itu.int/rec/T-REC-E.164/en). Supports only the `national_number` property.", "$ref": "#/components/schemas/phone" }, "address": { "description": "The portable international postal address. Maps to [AddressValidationMetadata](https://github.com/googlei18n/libaddressinput/wiki/AddressValidationMetadata) and HTML 5.1 [Autofilling form controls: the autocomplete attribute](https://www.w3.org/TR/html51/sec-forms.html#autofilling-form-controls-the-autocomplete-attribute).", "type": "object", "title": "Portable Postal Address (Medium-Grained)", "properties": { "address_line_1": { "type": "string", "description": "The first line of the address, such as number and street, for example, `173 Drury Lane`. Needed for data entry, and Compliance and Risk checks. This field needs to pass the full address.", "maxLength": 300 }, "address_line_2": { "type": "string", "description": "The second line of the address, for example, a suite or apartment number.", "maxLength": 300 }, "admin_area_2": { "type": "string", "description": "A city, town, or village. Smaller than `admin_area_level_1`.", "maxLength": 120 }, "admin_area_1": { "type": "string", "description": "The highest-level sub-division in a country, which is usually a province, state, or ISO-3166-2 subdivision. This data is formatted for postal delivery, for example, `CA` and not `California`. Value, by country, is:", "maxLength": 300 }, "postal_code": { "type": "string", "description": "The postal code, which is the ZIP code or equivalent. Typically required for countries with a postal code or an equivalent. See [postal code](https://en.wikipedia.org/wiki/Postal_code).", "maxLength": 60 }, "country_code": { "$ref": "#/components/schemas/country_code" } }, "required": ["country_code"] }, "attributes": { "$ref": "#/components/schemas/venmo_wallet_attributes_response" } } } }, "parameters": { "paypal_request_id": { "name": "PayPal-Request-Id", "in": "header", "description": "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).", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 108 } }, "paypal_partner_attribution_id": { "name": "PayPal-Partner-Attribution-Id", "in": "header", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 36 } }, "paypal_client_metadata_id": { "name": "PayPal-Client-Metadata-Id", "in": "header", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 36 } }, "prefer": { "name": "Prefer", "in": "header", "description": "The preferred server response upon successful completion of the request. Value is:", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 25, "pattern": "^[a-zA-Z=,-]*$", "default": "return=minimal" } }, "paypal_auth_assertion": { "name": "PayPal-Auth-Assertion", "in": "header", "description": "An API-caller-provided JSON Web Token (JWT) assertion that identifies the merchant. For details, see PayPal-Auth-Assertion.", "required": false, "schema": { "type": "string" } }, "id": { "name": "id", "in": "path", "description": "The ID of the order that the tracking information is associated with.", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 36, "pattern": "^[A-Z0-9]+$" } }, "fields": { "name": "fields", "description": "A comma-separated list of fields that should be returned for the order. Valid filter field is `payment_source`.", "in": "query", "required": false, "schema": { "type": "string", "pattern": "^[a-z_]*$" } }, "tracker_id": { "name": "tracker_id", "in": "path", "description": "The order tracking ID.", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 36, "pattern": "^[A-Z0-9]+$" } } } } }