DoAuthorization API Operation (NVP)
APILegacyLast updated: October 12th 2021, @ 6:58:00 pm
Authorizes a payment.
DoAuthorization Request Message
DoAuthorization Request Fields
Field | Description |
---|---|
| (Required) Must be |
| (Required) Value of the order's transaction identification number returned by PayPal. `partial:partials/docs/shared/cl_transactionid.en-XC` |
| (Required) Amount to authorize. Character length and limitations: `partial:partials/docs/shared/cl_currencylimit.en-XC` |
| (Optional) Type of transaction to authorize. The only allowable value is |
| (Optional) A three-character currency code. |
| (Optional) Sum of cost of all items in this order. Character length and limitations: `partial:partials/docs/shared/cl_currencylimit.en-XC` |
| (Optional) Total shipping costs for this order. Character length and limitations: `partial:partials/docs/shared/cl_currencylimit.en-XC` |
| (Optional) Total handling costs for this order. Character length and limitations: `partial:partials/docs/shared/cl_currencylimit.en-XC` |
| (Optional) Sum of tax for all items in this order. Character length and limitations: `partial:partials/docs/shared/cl_currencylimit.en-XC` |
| (Optional) Total shipping insurance costs for this order. |
| (Optional) Shipping discount for this order, specified as a negative number. Character length and limitations: `partial:partials/docs/shared/cl_currencylimit_neg.en-XC` |
| (Optional) Description of items the customer is purchasing. Character length and limitations: 127 single-byte alphanumeric characters. |
| (Optional) A free-form field for your own use. Character length and limitations: 256 single-byte alphanumeric characters. |
| (Optional) IP address of the buyer. |
|
(Optional) Indicates whether the item purchased is shipped to a store location. |
| (Optional) A message ID used for idempotence to uniquely identify a message. This ID can later be used to request the latest results for a previous request without generating a new request. Examples of this include requests due to timeouts or errors during the original request. Character length and limitations: string of up to 38 single-byte characters. This field is available since API version 92.0. |
AddressType Fields
Field | Description |
---|---|
| Person's name associated with this shipping address. It is required if using a shipping address. Character length and limitations: 128 double-byte characters |
| First street address. Required if using a shipping address. Character length and limitations: 100 single-byte characters |
| (Optional) Second street address. Character length and limitations: 100 single-byte characters |
| Name of city. Required if using a shipping address. Character length and limitations: 40 single-byte characters |
| State or province. Character length and limitations: 40 single-byte characters |
| U.S. ZIP code or other country-specific postal code. Required if using a U.S. shipping address; may be required for other countries. Character length and limitations: 20 single-byte characters |
| Country code. Required if using a shipping address. Character length and limitations: 2 single-byte characters |
| (Optional) Phone number. Character length and limitations: 20 single-byte characters |
PaymentDetailsItemType Fields
Field | Description |
---|---|
| (Optional) Item name. Character length and limitations: 127 single-byte characters |
| (Optional) Item number. Character length and limitations: 127 single-byte characters |
| (Optional) Item quantity. Character length and limitations: Any positive integer |
| (Optional) Item sales tax. Character length and limitations: `partial:partials/docs/shared/cl_currencylimit.en-XC` |
| (Optional) Cost of item. Character length and limitations: `partial:partials/docs/shared/cl_currencylimit.en-XC` |
| (Optional) Item description. Character length and limitations: 127 single-byte characters |
| (Optional) Information about the Item weight. |
| (Optional) Information about the Item length. |
| (Optional) Information about the item width. |
| (Optional) Information about the item height. |
| (Optional) URL for the item. Character length and limitations: no limit. |
| (Optional) Item category — physical or digital. |
DoAuthorization Response Message
DoAuthorization Response Fields
Field | Description |
---|---|
| (Optional) Authorization identification number. `partial:partials/docs/shared/cl_transactionid.en-XC` |
| Amount you specified in the request. Character length and limitations: `partial:partials/docs/shared/cl_currencylimit.en-XC` |
| (Optional) A message ID used for idempotence to uniquely identify a message. This ID can later be used to request the latest results for a previous request without generating a new request. Examples of this include requests due to timeouts or errors during the original request. Character length and limitations: string of up to 38 single-byte characters. This field is available since version 92.0. |