APM API (2023-06-01)

Authentication Set your headers

    Authorization: {your_credentials}
    Content-Type: application/json
    WP-Api-Version: 2023-06-01

Replace {your_credentials} with your base64-encoded Basic Auth username and password.

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.

Download OpenAPI description

openapi.json

openapi.yaml

Overview

License Worldpay

Servers

Try

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

Live

https://access.worldpay.com/

Create an APM payment

Request

Perform a sale.

Headers

Content-Typestringrequired

The content type of the request body

Value"application/json"

WP-Api-Versionstringrequired

The API version

Value"2023-06-01"

Bodyapplication/jsonrequired

instructionobjectrequired

narrativeobjectrequired

Details about the payment.

paymentInstrumentobjectrequired

The instrument used to take the payment

valueobjectrequired

The value of the payment.

merchantobjectrequired

entitystring[ 0 .. 32 ] characters^([a-zA-Z0-9]*)$required

The Access Entity entityReference.

Example: "MindPalaceLtd"

transactionReferencestring[ 0 .. 64 ] characters^[a-zA-Z0-9-_/!@#$%()*=.:;?[]{}~\+]*$required

application/json

{
  "transactionReference": "Memory265-13/08/1876",
  "merchant": {
    "entity": "default"
  },
  "instruction": {
    "narrative": {
      "line1": "MindPalace"
    },
    "value": {
      "amount": 35,
      "currency": "GBP"
    },
    "paymentInstrument": {
      "type": "paypal",
      "requestAutoSettlement": {
        "enabled": true
      },
      "shopperEmailAddress": "shopper@example.com",
      "billingAddress": {
        "address1": "221B Baker Street",
        "address2": "Marylebone",
        "address3": "Westminster",
        "postalCode": "NW1 6XE",
        "city": "London",
        "state": "Greater London",
        "countryCode": "GB"
      },
      "shippingAddress": {
        "address1": "The Palatine Centre",
        "postalCode": "DH1 3LE",
        "city": "Durham",
        "state": "County Durham",
        "countryCode": "GB"
      },
      "successURL": "https://example.com/success",
      "pendingURL": "https://example.com/pending",
      "failureURL": "https://example.com/failure",
      "cancelURL": "https://example.com/cancel"
    }
  }
}

Responses

Request successful

Bodyapplication/json

One of:

A payment resource.

_actionsobject

Actions that can be performed on the payment resource. These are dynamic based on factors such as the payment instrument and state of the payment.

partialReverseobject

The URL you can invoke to partially reverse the payment. Make sure to check it's present, not always present.

reverseobject

The URL you can invoke to reverse the payment. Make sure to check it's present, not always present.

settleobject

The URL you can invoke to settle the payment. Make sure to check it's present, not always present.

_linksobject

Links to resources related to the request.

selfobject

The URL you can invoke to fetch the last event for the payment.

lastEventstring

Enum"authorized""cancelFailed""cancelled""cancelRequested""sentForSettlement""settlementFailed""chargebackReversed""chargedBack""disputeExpired""disputeFundsHeld"

paymentIdstring

The identifier of the payment resource.

Response

application/json

{
  "paymentId": "3Ihrz_xFV1nTRAHhJABserDF09eNdqnSHh2H8qlv7QIZ4iW8JjMy1wo4b2GozzFtfnOUMIZGm4eSqTixJe1tGDzD3NTuoxp7Ud1N920NPyBiaK1MePsYPNh4StVn5GLv9dz9tm3t0o9KS2dze2cQ2iJdjRiX7-j4OEhFc5W4W6hK1prAjyQIHthwfovFL63f",
  "lastEvent": "pending",
  "url": "https://mock.hpp.worldpay.com/app/hpp/xyz/integration/wpg?Ticket=12345678&OrderKey=blah",
  "_links": {
    "self": {
      "href": "https://try.access.worldpay.com/apmPayments/3Ihrz_xFV1nTRAHhJABserDF09eNdqnSHh2H8qlv7QIZ4iW8JjMy1wo4b2GozzFtfnOUMIZGm4eSqTixJe1tGDzD3NTuoxp7Ud1N920NPyBiaK1MePsYPNh4StVn5GLv9dz9tm3t0o9KS2dze2cQ2iJdjRiX7-j4OEhFc5W4W6hK1prAjyQIHthwfovFL63f"
    }
  },
  "_actions": {}
}

Operational

Operations

Payment Lifecycle

Operations

Get the last event for an APM payment.

Request

Lookup the state of a payment, including the available action that can be performed.

Path

paymentIdstringrequired

The identifier of the payment resource.

Headers

WP-Api-Versionstringrequired

The API version

Value"2023-06-01"

No request payload

Responses

Request successful

Bodyapplication/json

_actionsobject

Actions that can be performed on the payment resource. These are dynamic based on factors such as the payment instrument and state of the payment.

partialReverseobject

The URL you can invoke to partially reverse the payment. Make sure to check it's present, not always present.

reverseobject

The URL you can invoke to reverse the payment. Make sure to check it's present, not always present.

settleobject

The URL you can invoke to settle the payment. Make sure to check it's present, not always present.

_linksobject

Links to resources related to the request.

selfobject

The URL you can invoke to fetch the last event for the payment.

lastEventstring

Enum"authorized""cancelFailed""cancelled""cancelRequested""sentForSettlement""settlementFailed""chargebackReversed""chargedBack""disputeExpired""disputeFundsHeld"

paymentIdstring

The identifier of the payment resource.

Response

application/json

{
  "paymentId": "3Ihrz_xFV1nTRAHhJABserDF09eNdqnSHh2H8qlv7QIZ4iW8JjMy1wo4b2GozzFtfnOUMIZGm4eSqTixJe1tGDzD3NTuoxp7Ud1N920NPyBiaK1MePsYPNh4StVn5GLv9dz9tm3t0o9KS2dze2cQ2iJdjRiX7-j4OEhFc5W4W6hK1prAjyQIHthwfovFL63f",
  "lastEvent": "authorized",
  "_links": {
    "self": {
      "href": "https://try.access.worldpay.com/apmPayments/3Ihrz_xFV1nTRAHhJABserDF09eNdqnSHh2H8qlv7QIZ4iW8JjMy1wo4b2GozzFtfnOUMIZGm4eSqTixJe1tGDzD3NTuoxp7Ud1N920NPyBiaK1MePsYPNh4StVn5GLv9dz9tm3t0o9KS2dze2cQ2iJdjRiX7-j4OEhFc5W4W6hK1prAjyQIHthwfovFL63f"
    }
  },
  "_actions": {
    "reverse": {
      "href": "https://try.access.worldpay.com/apmPayments/3Ihrz_xFV1nTRAHhJABserDF09eNdqnSHh2H8qlv7QIZ4iW8JjMy1wo4b2GozzFtfnOUMIZGm4eSqTixJe1tGDzD3NTuoxp7Ud1N920NPyBiaK1MePsYPNh4StVn5GLv9dz9tm3t0o9KS2dze2cQ2iJdjRiX7-j4OEhFc5W4W6hK1prAjyQIHthwfovFL63f/reversals"
    },
    "partialReverse": {
      "href": "https://try.access.worldpay.com/apmPayments/3Ihrz_xFV1nTRAHhJABserDF09eNdqnSHh2H8qlv7QIZ4iW8JjMy1wo4b2GozzFtfnOUMIZGm4eSqTixJe1tGDzD3NTuoxp7Ud1N920NPyBiaK1MePsYPNh4StVn5GLv9dz9tm3t0o9KS2dze2cQ2iJdjRiX7-j4OEhFc5W4W6hK1prAjyQIHthwfovFL63f/reversals"
    }
  }
}

Reverse an APM payment.

Request

Perform a reversal on the funds taken from a sale.

Path

paymentIdstringrequired

The identifier of the payment resource.

Headers

Content-Typestringrequired

The content type of the request body

Value"application/json"

WP-Api-Versionstringrequired

The API version

Value"2023-06-01"

Bodyapplication/jsonrequired

One of:

Full reversal request (no body)

object

Full reversal request (no body)

application/json

{}

Responses

Request successful

Bodyapplication/json

_actionsobject

Actions that can be performed on the payment resource. These are dynamic based on factors such as the payment instrument and state of the payment.

partialReverseobject

The URL you can invoke to partially reverse the payment. Make sure to check it's present, not always present.

reverseobject

The URL you can invoke to reverse the payment. Make sure to check it's present, not always present.

settleobject

The URL you can invoke to settle the payment. Make sure to check it's present, not always present.

_linksobject

Links to resources related to the request.

selfobject

The URL you can invoke to fetch the last event for the payment.

lastEventstring

Enum"authorized""cancelFailed""cancelled""cancelRequested""sentForSettlement""settlementFailed""chargebackReversed""chargedBack""disputeExpired""disputeFundsHeld"

paymentIdstring

The identifier of the payment resource.

Response

application/json

{
  "id": "3Ihrz_xFV1nTRAHhJABserDF09eNdqnSHh2H8qlv7QIZ4iW8JjMy1wo4b2GozzFtfnOUMIZGm4eSqTixJe1tGDzD3NTuoxp7Ud1N920NPyBiaK1MePsYPNh4StVn5GLv9dz9tm3t0o9KS2dze2cQ2iJdjRiX7-j4OEhFc5W4W6hK1prAjyQIHthwfovFL63f",
  "lastEvent": "sentForRefund",
  "_links": {
    "self": {
      "href": "https://try.access.worldpay.com/apmPayments/3Ihrz_xFV1nTRAHhJABserDF09eNdqnSHh2H8qlv7QIZ4iW8JjMy1wo4b2GozzFtfnOUMIZGm4eSqTixJe1tGDzD3NTuoxp7Ud1N920NPyBiaK1MePsYPNh4StVn5GLv9dz9tm3t0o9KS2dze2cQ2iJdjRiX7-j4OEhFc5W4W6hK1prAjyQIHthwfovFL63f"
    }
  },
  "_actions": {}
}

Settle an APM payment.

Request

Perform a settlement on authorized funds. Not all APMs support this, please check the links returned from querying a payment.

Path

paymentIdstringrequired

The identifier of the payment resource.

Headers

Content-Typestringrequired

The content type of the request body

Value"application/json"

WP-Api-Versionstringrequired

The API version

Value"2023-06-01"

Bodyapplication/jsonrequired

One of:

Full settlement request (no body)

object

Full settlement request (no body)

application/json

null

Responses

Request successful

Bodyapplication/json

_actionsobject

Actions that can be performed on the payment resource. These are dynamic based on factors such as the payment instrument and state of the payment.

partialReverseobject

The URL you can invoke to partially reverse the payment. Make sure to check it's present, not always present.

reverseobject

The URL you can invoke to reverse the payment. Make sure to check it's present, not always present.

settleobject

The URL you can invoke to settle the payment. Make sure to check it's present, not always present.

_linksobject

Links to resources related to the request.

selfobject

The URL you can invoke to fetch the last event for the payment.

lastEventstring

Enum"authorized""cancelFailed""cancelled""cancelRequested""sentForSettlement""settlementFailed""chargebackReversed""chargedBack""disputeExpired""disputeFundsHeld"

paymentIdstring

The identifier of the payment resource.

urlstring

The URL of where to redirect tyour customer.

Response

application/json

{
  "id": "3Ihrz_xFV1nTRAHhJABserDF09eNdqnSHh2H8qlv7QIZ4iW8JjMy1wo4b2GozzFtfnOUMIZGm4eSqTixJe1tGDzD3NTuoxp7Ud1N920NPyBiaK1MePsYPNh4StVn5GLv9dz9tm3t0o9KS2dze2cQ2iJdjRiX7-j4OEhFc5W4W6hK1prAjyQIHthwfovFL63f",
  "lastEvent": "sentForSettlement",
  "_links": {
    "self": {
      "href": "https://try.access.worldpay.com/apmPayments/3Ihrz_xFV1nTRAHhJABserDF09eNdqnSHh2H8qlv7QIZ4iW8JjMy1wo4b2GozzFtfnOUMIZGm4eSqTixJe1tGDzD3NTuoxp7Ud1N920NPyBiaK1MePsYPNh4StVn5GLv9dz9tm3t0o9KS2dze2cQ2iJdjRiX7-j4OEhFc5W4W6hK1prAjyQIHthwfovFL63f"
    }
  },
  "_actions": {}
}

APM API (2023-06-01)

Create an APM payment

Request

Responses

Do you like our page?

Operational

Payment Lifecycle

Get the last event for an APM payment.

Request

Responses

Do you like our page?

Reverse an APM payment.

Request

Responses

Do you like our page?

Settle an APM payment.

Request

Responses

Do you like our page?

APM API (2023-06-01)

Create an APM payment

RequestExpand all

Responses

Do you like our page?

Operational

Payment Lifecycle

Get the last event for an APM payment.

Request

Responses

Do you like our page?

Reverse an APM payment.

Request

Responses

Do you like our page?

Settle an APM payment.

Request

Responses

Do you like our page?

Request