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

# Trustly

A secure online payment transfer.

Note
Make yourself familiar with our [API principles](/products/reference/api-principles) to ensure a resilient integration.

details
summary
Product overview
### Feature summary

| Payment type | Recurring | Reversals | Partial reversals |
|  --- | --- | --- | --- |
| Bank Transfer | ❌ | Refund - yesCancel- No | Partial refund - yesPartial cancel- No |


### Acceptance currencies

| Currency | Currency codes |
|  --- | --- |
| Bulgarian Leva | BGN |
| Czech Koruna | CZK |
| Danish Krone | DKK |
| Euro | EUR |
| Polish zloty | PLN |
| Pound Sterling | GBP |
| Norwegian Krone | NOK |
| Romanian Leu | RON |
| Swedish Krona | SEK |


- Minimum Transaction Value: 1,00 for each currency
- Maximum Transaction Value: 10.000 EUR or currency equivalent


## Get started

Get started using our [API reference](/products/apms/openapi) and set your headers.

## Request

`POST` `https://try.access.worldpay.com/apmPayments`

### Example request

### Parameters

## Response

#### Successful request response

* an HTTP code 201
* a `paymentId` which is unique to the payment - we recommend storing the "id", as you can use it to manage the payment later
* a url to redirect your customer to the APM provider to complete the payment
* a link to query the payment status
* an object which will give flow information such as `method` (e.g. `trustly`) and type (`direct`)
* a `commandId` generated by us identifying a single merchant interaction (e.g. `cmdYNdIHBPJwbkjLiykzTx0`)


### Example response

Successful
{
  "paymentInstrument": {
    "method": "trustly",
    "type": "direct"
  },
  "paymentId": "eyJrIjoiYXBtLXNlcnZpY2UtZGVmYXVsdCIsImxpbmtWZXJzaW9uIjoiNi4wLjAifQ==.BnnxxcMle38OazhwbF8J+4rtJi8CAq:Y3zUOn1dw6VWfvx:PHL5L0S+5ara5vz6ouV5yBmVUQCiSwQjs+1x5qJIJxAKWMWc2Mlb1doricEYlzsZIRIGCflvnYu1Ns8g1S0+66n6wCELiB9OHfX7cdDZM8QaH19DiFbmMAchPSTyHNCTMvOMr7z:d61dLntVSAaFT9PiiV:KsP+z2Cdr9o:XFrnd4GNEHV7yDuZt9Jyqf5XZUPFYfD4fs2JzaCZKV3L7DQm7JfXl6rjXA0ubX6hJpY5kUX4Djm9+PFFKUS69VdPTc30HsveUM9XjnvE4YIx9jkBR3rQ+pDZRw+HYcrhKM2Ks:rlczHJ2DGe1:xPRqjBWEQYSfjhGO0ig5hWkD70cWvOUr9oNei3iC:3d01MiKXp01ZX4AeiXlWYKZF5hbcrjMRprcUptpLfoEB8QBFXfS8l+w00uMOJ3COd2qPA==",
  "lastEvent": "pending",
  "_links": {
    "self": {
      "href": "https://try.access.worldpay.com/apmPayments/eyJrIjoiYXBtLXNlcnZpY2UtZGVmYXVsdCIsImxpbmtWZXJzaW9uIjoiNi4wLjAifQ==.BnnxxcMle38OazhwbF8J+4rtJi8CAq:Y3zUOn1dw6VWfvx:PHL5L0S+5ara5vz6ouV5yBmVUQCiSwQjs+1x5qJIJxAKWMWc2Mlb1doricEYlzsZIRIGCflvnYu1Ns8g1S0+66n6wCELiB9OHfX7cdDZM8QaH19DiFbmMAchPSTyHNCTMvOMr7z:d61dLntVSAaFT9PiiV:KsP+z2Cdr9o:XFrnd4GNEHV7yDuZt9Jyqf5XZUPFYfD4fs2JzaCZKV3L7DQm7JfXl6rjXA0ubX6hJpY5kUX4Djm9+PFFKUS69VdPTc30HsveUM9XjnvE4YIx9jkBR3rQ+pDZRw+HYcrhKM2Ks:rlczHJ2DGe1:xPRqjBWEQYSfjhGO0ig5hWkD70cWvOUr9oNei3iC:3d01MiKXp01ZX4AeiXlWYKZF5hbcrjMRprcUptpLfoEB8QBFXfS8l+w00uMOJ3COd2qPA=="
    }
  },
  "_actions": {},
  "redirect": "http://secure-test.worldpay.com/redirect?tokenId=f1ff338b-a0d7-4a17-b64f-31b2b994391c",
  "commandId": "cmdKZ4gnUp1aNkfNi7Kmwi1N0"
}
Error response
{
  "errorName": "bodyDoesNotMatchSchema",
  "message": "The json body provided does not match the expected schema",
  "validationErrors": [
    {
      "errorName": "fieldHasInvalidValue",
      "message": "Field is mandatory",
      "jsonPath": "$.instruction.value.amount"
    }
  ]
}
#### Errors

Check out our API reference for the full [error code schema](/products/apms/openapi/other/payment#other/payment/response&c=400).

**Next steps**

[Manage your Trustly payment](/products/apms/manage/)