Increase authorization amount

Request

If you want to increase an initial estimated authorization amount (submitted with estimated set to true), you can send a incremental authorization request.

Note: You must use the latest next action links returned by the incremental authorization response to settle (full/partial) and cancel (full/partial) the increased authorized amount. Using the next action links returned in your estimated authorization response will not use any increased amounts.

Security

BasicAuth

Path

linkDatastringrequired

Action link that's received in your request.

Content-Typestringrequired

Example:application/vnd.worldpay.payments-v7+json

Acceptstringrequired

Example:application/vnd.worldpay.payments-v7+json

Bodyapplication/vnd.worldpay.payments-v7+json

valueobjectrequired

An object that contains information about the value of the payment.

Request to increase the initial estimated authorization

{
  "value": {
    "amount": 500,
    "currency": "EUR"
  }
}

Responses

The request to increase the authorization amount has been successfully processed

Bodyapplication/vnd.worldpay.payments-v7+json

outcomestring

Outcome of the request.

Enum:"authorized""refused"

Example:"authorized"

Discriminator

amountsobject

An object containing transaction amounts.

issuerobject

An object containing information returned by the issuer.

schemeobject

An object containing information returned by the card scheme.

_linksobject

Response

Successful response to increase an estimated authorization amount

{
  "outcome": "authorized",
  "amounts": {
    "totalAuthorized": 1100,
    "currency": "EUR"
  },
  "issuer": {
    "authorizationCode": "T91252"
  },
  "scheme": {
    "reference": "MCCRU3I5U0701"
  },
  "_links": {
    "cardPayments:increaseAuthorizedAmount": {
      "href": "/payments/authorizations/incrementalAuthorizations/:linkData"
    },
    "cardPayments:cancel": {
      "href": "/payments/authorizations/cancellations/:linkData"
    },
    "cardPayments:partialCancel": {
      "href": "/payments/authorizations/cancellations/partials/:linkData"
    },
    "cardPayments:settle": {
      "href": "/payments/settlements/full/:linkData"
    },
    "cardPayments:partialSettle": {
      "href": "/payments/settlements/partials/:linkData"
    },
    "cardPayments:events": {
      "href": "/payments/events/:linkData"
    },
    "curies": [
      {
        "name": "payments",
        "href": "/rels/payments/{rel}",
        "templated": true
      }
    ]
  }
}