Reauthorize authorized payment

curl --request POST \
  --url https://api-m.sandbox.paypal.com/v2/payments/authorizations/{authorization_id}/reauthorize \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "amount": {
    "value": "10.99",
    "currency_code": "USD"
  }
}'

{
  "status": "CREATED",
  "status_details": {
    "reason": "PENDING_REVIEW"
  },
  "id": "<string>",
  "amount": {
    "currency_code": "<string>",
    "value": "<string>"
  },
  "invoice_id": "<string>",
  "custom_id": "<string>",
  "network_transaction_reference": {
    "id": "<string>",
    "date": "<string>",
    "network": "VISA",
    "acquirer_reference_number": "<string>"
  },
  "seller_protection": {
    "status": "ELIGIBLE",
    "dispute_categories": [
      "ITEM_NOT_RECEIVED"
    ]
  },
  "expiration_time": "<string>",
  "links": [
    {
      "href": "<string>",
      "rel": "<string>",
      "method": "GET"
    }
  ],
  "create_time": "<string>",
  "update_time": "<string>",
  "supplementary_data": {
    "related_ids": {
      "order_id": "<string>",
      "authorization_id": "<string>",
      "capture_id": "<string>"
    }
  },
  "payee": {
    "email_address": "<string>",
    "merchant_id": "<string>"
  }
}

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 from 4 to 29 days after the 3-day honor period. The allowed amount depends on context and geography, for example in US it is up to 115% of the original authorized amount, not to exceed an increase of $75 USD.

Supports only the amount request parameter.

POST

payments

authorizations

{authorization_id}

reauthorize

Reauthorize authorized payment

curl --request POST \
  --url https://api-m.sandbox.paypal.com/v2/payments/authorizations/{authorization_id}/reauthorize \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "amount": {
    "value": "10.99",
    "currency_code": "USD"
  }
}'

{
  "status": "CREATED",
  "status_details": {
    "reason": "PENDING_REVIEW"
  },
  "id": "<string>",
  "amount": {
    "currency_code": "<string>",
    "value": "<string>"
  },
  "invoice_id": "<string>",
  "custom_id": "<string>",
  "network_transaction_reference": {
    "id": "<string>",
    "date": "<string>",
    "network": "VISA",
    "acquirer_reference_number": "<string>"
  },
  "seller_protection": {
    "status": "ELIGIBLE",
    "dispute_categories": [
      "ITEM_NOT_RECEIVED"
    ]
  },
  "expiration_time": "<string>",
  "links": [
    {
      "href": "<string>",
      "rel": "<string>",
      "method": "GET"
    }
  ],
  "create_time": "<string>",
  "update_time": "<string>",
  "supplementary_data": {
    "related_ids": {
      "order_id": "<string>",
      "authorization_id": "<string>",
      "capture_id": "<string>"
    }
  },
  "payee": {
    "email_address": "<string>",
    "merchant_id": "<string>"
  }
}

Authorizations

Authorization

string

header

required

OAuth 2.0 authentication

Headers

PayPal-Request-Id

string

The server stores keys for 45 days.

Prefer

string

default:return=minimal

The preferred server response upon successful completion of the request. Value is:<ul><li><code>return=minimal</code>. The server returns a minimal response to optimize communication between the API caller and the server. A minimal response includes the <code>id</code>, <code>status</code> and HATEOAS links.</li><li><code>return=representation</code>. The server returns a complete resource representation, including the current state of the resource.</li></ul>

PayPal-Auth-Assertion

string

An API-caller-provided JSON Web Token (JWT) assertion that identifies the merchant. For details, see PayPal-Auth-Assertion.<blockquote>Note:For three party transactions in which a partner is managing the API calls on behalf of a merchant, the partner must identify the merchant using either a PayPal-Auth-Assertion header or an access token with target_subject.</blockquote>

Path Parameters

authorization_id

string

required

The PayPal-generated ID for the authorized payment to void.

Body

application/json

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. You can reauthorize a payment only once from days four to 29. 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. The allowed amount depends on context and geography, for example in US it is up to 115% of the original authorized amount, not to exceed an increase of $75 USD. Supports only the amount request parameter.

amount

object

The amount to reauthorize for an authorized payment.

Show child attributes

Response

A successful request returns the HTTP <code>200 OK</code> status code and a JSON response body that shows the reauthorized payment details.

The authorized payment transaction. The status fields and status details for an authorized payment. The date and time stamps that are common to authorized payment, captured payment, and refund transactions.

supplementary_data

object

An object that provides supplementary/additional data related to a payment transaction.

Show child attributes

payee

object

The details associated with the merchant for this transaction.

Show child attributes

status

enum<string>

The status for the authorized payment.

Available options:

CREATED,

CAPTURED,

DENIED,

PARTIALLY_CAPTURED,

VOIDED,

PENDING

status_details

object

The details of the authorized order pending status.

Show child attributes

create_time

string<ppaas_date_time_v3>

The date and time when the transaction occurred, in Internet date and time format.

Required string length: 20 - 64

update_time

string<ppaas_date_time_v3>

The date and time when the transaction was last updated, in Internet date and time format.

Required string length: 20 - 64

string

The PayPal-generated ID for the authorized payment.

amount

object

The amount for this authorized payment.

Show child attributes

invoice_id

string

The API caller-provided external invoice number for this order. Appears in both the payer's transaction history and the emails that the payer receives.

custom_id

string

The API caller-provided external ID. Used to reconcile API caller-initiated transactions with PayPal transactions. Appears in transaction and settlement reports.

Maximum length: 255

network_transaction_reference

object

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

Show child attributes

seller_protection

object

The level of protection offered as defined by PayPal Seller Protection for Merchants.

Show child attributes

expiration_time

string<ppaas_date_time_v3>

The date and time when the authorized payment expires, in Internet date and time format.

Required string length: 20 - 64

links

Link Description · object[]

An array of related HATEOAS links.

Show child attributes

Capture authorized payment

Void authorized payment

⌘I

Orders v2

Payments v2

Payment Method Tokens v3

Invoicing v2

Currency Exchange v2

Reporting Transactions v1

Payments Payouts Batch v1

Notifactions Webhooks v1

Customer Disputes v1

Reauthorize authorized payment

Authorizations

Headers

Path Parameters

Body

Response