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

# Manage your payments

- [Reversals](#reversal)
- [Events](#events)


## Reversal

`POST` your request to the `direct:reverse` action link.

Note
No request body is needed for this request.

### Reversal example request

`POST` `https://try.access.worldpay-bsh.securedataplatform.com/payments/alternative/direct/reversals/linkData`

### Reversal response

You receive:

* an HTTP code `201`
* the `outcome` for your `reversal` request
* a link to [query](/products/card-payments/v6/query-a-payment) your payment


Example response:

{
    "_links": {
        "direct:events": {
            "href": "https://try.access.worldpay-bsh.securedataplatform.com/payments/alternative/direct/linkData"
        },
        "curies": [{
            "name": "direct",
            "href": "https://try.access.worldpay-bsh.securedataplatform.com/rels/payments/alternative/direct/{rels}",
            "templated": true
        }]
    }
}
## Query and Events

`GET` your request to the `direct:events` action link.

Note
No request body is needed for this request.

### Query example request

`GET` `https://try.access.worldpay-bsh.securedataplatform.com/payments/alternative/direct/events?transactionReference=uniqueReference&entity=yourMerchantEntity`

### Query responses

You receive:

* an HTTP code `201`
* the `outcome` for your `events` request
* links to [reverse](/products/apms/20230601/paydirect/manage-payment#reversal) or [query](/products/card-payments/v6/query-a-payment) your payment


Example response:

{
    "outcome": "sentForSettlement|refused|reversed",
    "_links": {
        "direct:events": {
            "href": "https://try.access.worldpay-bsh.securedataplatform.com/payments/alternative/direct/linkData"
        },
        "direct:reversal": {
            "href": "https://try.access.worldpay-bsh.securedataplatform.com/payments/alternative/direct/reversals/linkData"
        },
        "curies": [{
            "name": "direct",
            "href": "https://try.access.worldpay-bsh.securedataplatform.com/rels/payments/alternative/direct/{rels}",
            "templated": true
        }]
    }
}
### Events example request

`GET`  `https://try.access.worldpay-bsh.securedataplatform.com/payments/alternative/direct/events/linkData`

### Events responses

You receive:

* an HTTP code `201`
* the `lastEvent` for your `events` request
* links to [reverse](/products/apms/20230601/paydirect/manage-payment#reversal) or [query](/products/card-payments/v6/query-a-payment) your payment


Example response:

{
    "lastEvent": "sentForSettlement|refused|reversed",
    "_links": {
        "direct:events": {
            "href": "https://try.access.worldpay-bsh.securedataplatform.com/payments/alternative/direct/linkData"
        },
        "direct:reversal": {
            "href": "https://try.access.worldpay-bsh.securedataplatform.com/payments/alternative/direct/reversals/linkData"
        },
        "curies": [{
            "name": "direct",
            "href": "https://try.access.worldpay-bsh.securedataplatform.com/rels/payments/alternative/direct/{rels}",
            "templated": true
        }]
    }
}