On This Page

Re-authorize a PayPal Payment

Re-authorizing an authorized PayPal payment maintains the 3-day honor period in which you can capture the payment. If the 3-day honor period expires because you did not send a re-authorization request, PayPal contacts the card's issuer to re-authorize the payment. When the issuer approves the re-authorization, PayPal accepts the capture request you submitted. Re-authorizing an authorization also enables you to change the payment amount. You can begin requesting a re-authorization 3 days after the original authorization was requested. If you reauthorize a payment on the 28th day of its authorization period, you only have 1 day to capture it. You can only re-authorize PayPal
payments. Re-authorizing a payment using saved credentials is not supported.

IMPORTANT

If you need to reverse a re-authorized payment, use the initial authorization request ID in the reversal request.

Endpoints

Production:

POST https://api.cybersource.com/pts/v2/payments/

Test:

POST https://apitest.cybersource.com/pts/v2/payments/

Required Fields for Re-authorizing a PayPal Payment

orderInformation.amountDetails.currency
orderInformation.amountDetails.totalAmount
paymentInformation.paymentType.method.name: Set to one of these values:

payPal
: the PayPal payment method.
venmo
: the Venmo payment method.
paymentInformation.paymentType.name: Set to
eWallet
.
processingInformation.actionList: Set to
AP_REAUTH
.
processingInformation.linkId

Example: Re-authorizing a PayPal Payment

Request

{
  "orderInformation": {
    "amountDetails": {
      "totalAmount": "31.00",
      "currency": "USD"
    }
  },
  "paymentInformation": {
    "paymentType": {
      "method": {
        "name": "payPal"
      },
      "name": "eWallet"
    }
  },
  "processingInformation": {
    "actionList": [
      "AP_REAUTH"
    ],
    "linkId": "7261189513277014411040"
  }
}

Response to a Successful Request

{
  "submitTimeUtc": "2024-09-18T05:11:30Z",
  "processorInformation": {
    "transactionId": "8XL39452XB324090U",
    "expirationTimeUtc": "2024-10-11T05:29:13Z",
    "updateTimeUtc": "2024-09-18T05:11:30Z"
  },
  "message": "Successful",
  "status": "COMPLETED",
  "id": "7266362888326306001991"
}

Response Statuses for Re-authorizing a PayPal Payment

Cybersource responds to your request with one of these statuses in the

status

response field:

INVALID_REQUEST

: The request was not successful. Send a new authorization request.

PENDING

: The request was successful, and PayPal is reviewing the request. Use the check status request as often as necessary until the status updates.

When you request a status update, Cybersource responds with this status in the

status

field:

COMPLETED

: The request was successful and the authorization is updated.