Skip to content
APIs/Card Payments/Take a one-time payment

Payments (5)

Payments root resource, returns links to available payments actions.

Download OpenAPI description
openapi.json
openapi.yaml
Languages
Servers
Test (Try)
https://try.access.worldpay.com
Live
https://access.worldpay.com

Take a one-time payment

To take a payment, you must first create an authorization request. Your response contains links to your next available actions.

Operations

Creates an authorization

Request

Take online card payments using our Card Payments API.

Security
BasicAuth
Headers
Content-Typestringrequired
Example: application/vnd.worldpay.payments-v5+json
Acceptstring
Example: application/vnd.worldpay.payments-v5.hal+json
Bodyapplication/vnd.worldpay.payments-v5+json
instructionobjectrequired
valueobjectrequired
narrativeobjectrequired
paymentInstrumentanyrequired
debtRepaymentboolean
merchantobjectrequired
entitystringrequired
mccstring
paymentFacilitatorobject
transactionReferencestringrequired
channelstring
Value"moto"
customerobject
authenticationobjectrequired
application/vnd.worldpay.payments-v5+json

An example of a payment authorization for GBP 2.50 with a successful outcome

{
  "transactionReference": "transaction-ref",
  "merchant": {
    "entity": "an-entity"
  },
  "instruction": {
    "narrative": {
      "line1": "trading name"
    },
    "value": {
      "currency": "GBP",
      "amount": 250
    },
    "paymentInstrument": {
      "type": "card/plain",
      "cardNumber": "4444333322221111",
      "cardExpiryDate": {
        "month": 12,
        "year": 2024
      },
      "cardHolderName": "John Appleseed"
    }
  }
}

Responses

The payment authorization has been successfully created

Bodyapplication/vnd.worldpay.payments-v5.hal+json
outcomestringrequired
issuerobject
authorizationCodestringrequired
paymentInstrumentobject
typestring
cardobject
riskFactorsArray of objects

Any risk factors which have been identified for the authorization. This section will not appear if no risks are identified.

typestringrequired
Enum"avs""cvc"
riskstringrequired
Enum"not_checked""not_matched""not_supplied"
detailstring
Enum"address""postcode"
schemeobject
referencestringrequired
Response
application/vnd.worldpay.payments-v5.hal+json

An example of a payment authorization for GBP 2.50 with a successful outcome

{
  "outcome": "authorized",
  "_links": {
    "payments:cancel": {
      "href": "/payments/authorizations/cancellations/linkData"
    },
    "payments:settle": {
      "href": "/payments/settlements/linkData"
    },
    "payments:partialSettle": {
      "href": "/payments/settlements/partials/linkData"
    },
    "payments:events": {
      "href": "/payments/events/linkData"
    },
    "curies": [
      {
        "name": "payments",
        "href": "/rels/payments/{rel}",
        "templated": true
      }
    ]
  }
}

Take repeat payments

Take a payment using a stored credential

Operations

Manage payments

Cancel, settle, refund or reverse payments

Operations

Query a payment

Send a request to find out the current status of your payment after it has been authorized.

Operations