# 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 Worldpay Implementation Manager.

You **must** use the `Authorization` header for any request you send to our APMs API.


__DNS Whitelisting__
    
Whitelist the following URLs:
* https://try.access.worldpay.com/
* https://access.worldpay.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:
  - generated: true
  - business: Enterprise
  - catalog-list: true
  - category: Alternative Payments

## Servers

Try
```
https://try.access.worldpay.com
```

Live
```
https://access.worldpay.com
```

## Security

### BasicAuth

Type: http
Scheme: basic

## Download OpenAPI description

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

## Payment

### Create an APM payment

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

## 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 APM 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): Perform a settlement on authorized funds. Not all APMs support this, please check the links returned from querying a payment.

### Partial settle an APM payment

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