Reauthorize authorized payment

Reauthorizes an authorized PayPal account payment, by ID. To ensure that funds are still available, reauthorize a payment after its initial three-day honor period expires. Within the 29-day authorization period, you can issue multiple re-authorizations after the honor period expires.

If 30 days have transpired since the date of the original authorization, you must create an authorized payment instead of reauthorizing the original authorized payment.

A reauthorized payment itself has a new honor period of three days.

You can reauthorize an authorized payment once for up to 115% of the original authorized amount, not to exceed an increase of $75 USD.

Supports only the amount request parameter.

Note: This request is currently not supported for Partner use cases.

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Basic 之后拼接空格，以及经过 Base64 编码的 username:password

示例：

Authorization: Basic *****************

Path 参数

authorization_id

string

必需

(Required) The PayPal-generated ID for the authorized payment to reauthorize.

示例值:

Header 参数

Content-Type

string

必需

The Content-Type header field is used to specify the nature of the data in the body of an entity. PayPal REST APIs support application/json.

示例值:

application/json

PayPal-Request-Id

string

必需

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.

示例值:

Prefer

string

必需

The preferred server response upon successful completion of the request. Value is:

return=minimal. The server returns a minimal response to optimize communication between the API caller and the server. A minimal response includes the id, status and HATEOAS links.
return=representation. The server returns a complete resource representation, including the current state of the resource.

示例值:

Body 参数application/json

amount

object

必需

value

string

必需

currency_code

string

必需

示例

{
  "amount": {
    "value": "10.99",
    "currency_code": "USD"
  }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢201201 - Reauthorize The Authorized Payment

application/json

Body

string

必需

status

string

必需

amount

object

必需

currency_code

string

必需

value

string

必需

seller_protection

object

必需

status

string

必需

dispute_categories

array[string]

必需

supplementary_data

object

必需

related_ids

object

必需

expiration_time

string

必需

create_time

string

必需

update_time

string

必需

links

array [object {3}]

必需

href

string

必需

rel

string

必需

method

string

必需

示例

{
  "id": "8E048424862171107",
  "status": "CREATED",
  "amount": {
    "currency_code": "USD",
    "value": "10.99"
  },
  "seller_protection": {
    "status": "ELIGIBLE",
    "dispute_categories": [
      "ITEM_NOT_RECEIVED",
      "UNAUTHORIZED_TRANSACTION"
    ]
  },
  "supplementary_data": {
    "related_ids": {
      "order_id": "9P375962UG756752D"
    }
  },
  "expiration_time": "2022-02-18T19:00:46Z",
  "create_time": "2022-02-07T23:47:24Z",
  "update_time": "2022-02-07T23:47:24Z",
  "links": [
    {
      "href": "https://api.sandbox.paypal.com/v2/payments/authorizations/8E048424862171107",
      "rel": "self",
      "method": "GET"
    },
    {
      "href": "https://api.sandbox.paypal.com/v2/payments/authorizations/8E048424862171107/capture",
      "rel": "capture",
      "method": "POST"
    },
    {
      "href": "https://api.sandbox.paypal.com/v2/payments/authorizations/8E048424862171107/void",
      "rel": "void",
      "method": "POST"
    },
    {
      "href": "https://api.sandbox.paypal.com/v2/payments/authorizations/8E048424862171107/reauthorize",
      "rel": "reauthorize",
      "method": "POST"
    },
    {
      "href": "https://api.sandbox.paypal.com/v2/checkout/orders/9P375962UG756752D",
      "rel": "up",
      "method": "GET"
    }
  ]
}

🟠401401 Unauthorized - Invalid Token

🟠401401 Unauthorized - Permission Denied

🟠404404 Not Found - Authorization Not Found

🟠422422 Unprocessable Entity - Authorization Already Captured

🟠422422 Unprocessable Entity - Reauthorization Too Soon

⚪0422 Unprocessable Entity - Transaction In Progress