# APMs

Pay using eWallets, bank transfers, direct debits, local card schemes, Postpay and eInvoice/ Buy Now Pay Later.


  __Set your headers__
```
    Authorization: {your_credentials}
    Content-Type: application/json
    WP-Api-Version: 2024-07-01
```
    Replace `{your_credentials}` with your base64-encoded Basic Auth username and password given to you by your Implementation Manager.
    <br><br>
  You **must** use the `Authorization` header for any request you send to our APMs API. <br /><br />   __DNS whitelisting__

    Whitelist the following URLs:
    * `https://try.access.worldpay-bsh.securedataplatform.com/`
    * `https://access.worldpay-bsh.securedataplatform.com/`

    Please ensure you use DNS whitelisting, not explicit IP whitelisting.
    When you make a request within Access Worldpay, you should always cache the response returned.
 

Version: 2024-07-01
Metadata:
  - category: ["Alternative Payments"]
  - business: ["Enterprise"]
  - catalog-list: true
  - generated: false

## Servers

Test (Try)
```
https://try.access.worldpay-bsh.securedataplatform.com
```

Live
```
https://access.worldpay-bsh.securedataplatform.com
```

## Security

### BasicAuth

Type: http
Scheme: basic

## Download OpenAPI description

[APMs](https://worldpay-portal.eu.redocly.app/access/_bundle/products/apms/@20240701/openapi.yaml)

## Operational

### Used to check whether the service is up

 - [GET /apmPayments/status](https://worldpay-portal.eu.redocly.app/access/products/apms/openapi/operational/status.md)

## Payment lifecycle

### Get the last event for an APM payment

 - [GET /apmPayments/{paymentId}](https://worldpay-portal.eu.redocly.app/access/products/apms/openapi/payment-lifecycle/query.md): Lookup the state of a payment, including the available action that can be performed.

### Confirm payment

 - [POST /apmPayments/{paymentId}/confirmations](https://worldpay-portal.eu.redocly.app/access/products/apms/openapi/payment-lifecycle/confirmpaymentv2.md): Create a confirm payment request for smart button functionality.

### Reverse an APM payment

 - [POST /apmPayments/{paymentId}/reversals](https://worldpay-portal.eu.redocly.app/access/products/apms/openapi/payment-lifecycle/reverse.md): Perform a reversal on the funds taken from a sale.

### Partial reverse an APM payment

 - [POST /apmPayments/{paymentId}/partialReversals](https://worldpay-portal.eu.redocly.app/access/products/apms/openapi/payment-lifecycle/partialreversev2.md): Perform a partial reversal on the funds taken from a sale.

### Settle an APM payment

 - [POST /apmPayments/{paymentId}/settlements](https://worldpay-portal.eu.redocly.app/access/products/apms/openapi/payment-lifecycle/settle.md)

### Partial settle an APM payment

 - [POST /apmPayments/{paymentId}/partialSettlements](https://worldpay-portal.eu.redocly.app/access/products/apms/openapi/payment-lifecycle/settlev2.md): Perform a settlement on authorized funds. Not all APMs support this, please check the links returned from querying a payment.

## Other

### Create an APM payment

 - [POST /apmPayments](https://worldpay-portal.eu.redocly.app/access/products/apms/openapi/other/payment.md): Perform a sale.