Submit a payment refund request

Request

Send a refund request to return the full settled amount of a payment to your customer.

Note: No request body is needed for this request.

Security

BasicAuth

Path

linkDatastringrequired

WP-Api-Versionstringrequired

The API version

Value:"2024-06-01"

Example:2024-06-01

curl -i -X POST \
  -u '<username>:<password>' \
  'https://try.access.worldpay.com/api/payments/{linkData}/refunds' \
  -H 'WP-Api-Version: 2024-06-01'

Responses

Accepted

Bodyapplication/json

outcomestring

Value:"sentForRefund"

paymentIdstring^[A-Za-z0-9_-]+$

Unique identifier generated by us for a single payment. Generated at authorization, and maintained through successive payment actions.

_linksobject

Return details about the status of the payment.

Response

{
  "outcome": "sentForRefund",
  "paymentId": "payI-dUcet9fk4_X4qZU0hpU0",
  "_links": {
    "self": {
      "href": "https://try.access.worldpay.com/api/payments/eyJrIjoxLCJkIjoiN3VTNVpzK1h4UVFNL1R4aGZjSVV5TFFhMWZlNXRLOVM3M0k1MVdwN21PMXIySnNadTJ5YUhzZE45dDN5TDRnYk8rQk9PTzJzVWUxTkZUeXFBWjJZMUE9PSJ9"
    }
  }
}