Settle for partial amount

Request

To receive a portion of the funds of a payment, send us a partial settle request.

Security

BasicAuth

Path

linkDatastringrequired

Action link that's received in your request

Content-Typestringrequired

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

Acceptstring

Example:application/vnd.worldpay.payments-v6.hal+json

Bodyapplication/vnd.worldpay.payments-v6+json

valueobjectrequired

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

referencestringrequired

Request to partially settle the authorization

{
  "value": {
    "amount": 500,
    "currency": "EUR"
  },
  "reference": "partial-settle-reference"
}

Responses

The partial settlement has been accepted

Bodyapplication/vnd.worldpay.payments-v6.hal+json

Response

Request to partially settle the authorization

{
  "_links": {
    "payments:refund": {
      "href": "/payments/settlements/refunds/full/:linkData"
    },
    "payments:partialRefund": {
      "href": "/payments/settlements/refunds/partials/:linkData"
    },
    "payments:partialSettle": {
      "href": "/payments/settlements/partials/:linkData"
    },
    "payments:cancel": {
      "href": "/payments/authorizations/cancellations/:linkData"
    },
    "payments:events": {
      "href": "/payments/events/:linkData"
    },
    "curies": [
      {
        "name": "payments",
        "href": "/rels/payments/{rel}",
        "templated": true
      }
    ]
  }
}