**Last updated**: 17 November 2025 | [**Change log**](/products/apms/changelog/)

# Manage your APM

An overview on how to get the latest payment status and how to reverse (cancel or refund) and settle payments.

- [Query](#query)
- [Events](#events)
- [Settle](#settle)
- [Reverse](#reverse)


## Get payment status

There are two ways to get the payment status. You can either [query the payment](#query-payment) or [setup webhooks](/products/events) to receive the latest event from us.

### Query payment

Make a GET request on the `link:self` action link returned in your payment response.

`GET` `https://try.access.worldpay-bsh.securedataplatform.com/apmPayments/3Ihrz_xFV1nTRAHhJABserDF09eNdqnSHh2H8qlv7QIZ4iW8JjMy1wo4b2GozzFtfnOUMIZGm4eSqTixJe1tGDzD3`

Note
No request body is needed for this request.

#### You receive:

* an HTTP code 200
* the `lastEvent` for your query request
* links to available next actions for your payment


#### Example Query Response

{
  "paymentId": "3Ihrz_xFV1nTRAHhJABserDF09eNdqnSHh2H8qlv7QIZ4iW8JjMy1wo4b2GozzFtfnOUMIZGm4eSqTixJe1tGDzD3NTuoxp7Ud1N920NPyBiaK1MePsYPNh4StVn5GLv9dz9tm3t0o9KS2dze2cQ2iJdjRiX7-j4OEhFc5W4W6hK1prAjyQIHthwfovFL63f",
  "lastEvent": "authorized",
  "_links": {
    "self": {
      "href": "https://try.access.worldpay-bsh.securedataplatform.com/apmPayments/3Ihrz_xFV1nTRAHhJABserDF09eNdqnSHh2H8qlv7QIZ4iW8JjMy1wo4b2GozzFtfnOUMIZGm4eSqTixJe1tGDzD3NTuoxp7Ud1N920NPyBiaK1MePsYPNh4StVn5GLv9dz9tm3t0o9KS2dze2cQ2iJdjRiX7-j4OEhFc5W4W6hK1prAjyQIHthwfovFL63f"
    },
    "reverse": {
      "href": "https://try.access.worldpay-bsh.securedataplatform.com/apmPayments/3Ihrz_xFV1nTRAHhJABserDF09eNdqnSHh2H8qlv7QIZ4iW8JjMy1wo4b2GozzFtfnOUMIZGm4eSqTixJe1tGDzD3NTuoxp7Ud1N920NPyBiaK1MePsYPNh4StVn5GLv9dz9tm3t0o9KS2dze2cQ2iJdjRiX7-j4OEhFc5W4W6hK1prAjyQIHthwfovFL63f/reversals"
    },
    "partialReverse": {
      "href": "https://try.access.worldpay-bsh.securedataplatform.com/apmPayments/3Ihrz_xFV1nTRAHhJABserDF09eNdqnSHh2H8qlv7QIZ4iW8JjMy1wo4b2GozzFtfnOUMIZGm4eSqTixJe1tGDzD3NTuoxp7Ud1N920NPyBiaK1MePsYPNh4StVn5GLv9dz9tm3t0o9KS2dze2cQ2iJdjRiX7-j4OEhFc5W4W6hK1prAjyQIHthwfovFL63f/reversals"
    },
    "settle": {
      "href": "https://try.access.worldpay-bsh.securedataplatform.com/apmPayments/3Ihrz_xFV1nTRAHhJABserDF09eNdqnSHh2H8qlv7QIZ4iW8JjMy1wo4b2GozzFtfnOUMIZGm4eSqTixJe1tGDzD3NTuoxp7Ud1N920NPyBiaK1MePsYPNh4StVn5GLv9dz9tm3t0o9KS2dze2cQ2iJdjRiX7-j4OEhFc5W4W6hK1prAjyQIHthwfovFL63f/settlements"
    }
  }
}
#### Possible `lastEvent` values

* `authorized`
* `cancelFailed`
* `cancelled`
* `cancelledByCustomer`
* `cancelRequested`
* `chargebackReversed`
* `chargedBack`
* `disputeExpired`
* `disputeFundsHeld`
* `disputeFundsReleased`
* `disputeReserveReleased`
* `disputeInformationRequested`
* `disputInformationSupplied`
* `error`
* `expired`
* `manuallyAmended`
* `miscellaneous`
* `pending`
* `refunded`
* `refundExpired`
* `refundFailed`
* `refundReversed`
* `refused`
* `refusedByIssuer`
* `requestExpired`
* `sentForRefund`
* `sentForSettlement`
* `settled`
* `settlementReversed`
* `settlementFailed`
* `signedFormReceived`
* `unknown`


### Events

To use our webhooks take a look at our [events documentation](/products/events).

## Settle

Make a settle request to settle an authorized payment.

Note
Not all APMs support the settle request. Please refer to the individual APM documentation to understand if this action is supported for the APM.

`POST` `https://try.access.worldpay-bsh.securedataplatform.com/apmPayments/3Ihrz_xFV1nTRAHhJABserDF09eNdqnSHh2H8qlv7QIZ4iW8JjMy1wo4b2GozzFtfnOUMIZGm4eSqTixJe1tGDzD3/settlements`

Note
No request body is needed for this request.

## Reverse

Your reverse request is processed as a cancel or refund request. This depends on the time passed after your payment request was completed.

* an `authorized` payment status = `cancel`
* a `settled` or `sentForSettlement` payment status = `refund`


 Not all APMs support the reverse request. Some may only support refund, requiring the payment to be in a settled state before a reverse request can be processed. Please refer to the individual APM documentation to understand if this action is supported for the APM. 

POST to the `links:reverse` action link returned in your query response or append the payments “id” to the reverse url template.

`POST` `https://access.worldpay-bsh.securedataplatform.com/apmPayments/3Ihrz_xFV1nTRAHhJABserDF09eNdqnSHh2H8qlv7QIZ4iW8JjMy1wo4b2GozzFtfnOUMIZGm4eSqTixJe1tGDzD3/reversals`

## Full Reverse

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

Note
No request body is needed for this request.

## Partial Reverse

Send a partial reverse request to return a portion of the payment amount to your customer.

### Example partial request

{
    "reference": "0-128characters",
    "value": {
        "amount": 25,
        "currency": "GBP"
    }
}