Unfortunately, this feature is not supported on mobile devices. For the best experience, please use a computer.

Card Payments (6)

Payments root resource, returns links to available payments actions.

Download OpenAPI description
Languages
Servers
testing (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

Create an authorization

Request

Take online card payments using our Card Payments API.

Headers
Content-Typestringrequired
Example:

application/vnd.worldpay.payments-v6+json

Acceptstring
Example:

application/vnd.worldpay.payments-v6.hal+json

Bodyapplication/vnd.worldpay.payments-v6+json
instructionobjectrequired

An object that contains all information related to the payment.

valueobjectrequired

An object that contains information about the value of the payment.

amountintegerrequired

The payment amount. This is a whole number with an exponent e.g. if exponent is two, 250 is 2.50.

currencystringrequired

The three digit currency code.

narrativeobjectrequired

The text that appears on your customer's statement. Used to identify the merchant.

line1stringrequired

The first line of the narrative which appears on your customer's statement (24 characters max. If character is not supported it is replaced with a space).

line2string

Additional details about the payment e.g. order number, telephone number.

paymentInstrumentobjectrequired
cardExpiryDateobjectrequired

Contains your customer's card expiry date.

monthintegerrequired
yearintegerrequired
typestringrequired

An identifier for the paymentInstrument being used.

Value"card/plain"
Discriminator
cardNumberstringrequired

Contains your customer's card number.

billingAddressobject

Contains the billing address information.

cardHolderNamestring

The cardholder's name as it appears on their card.

cvcstring

CVC is a unique set of 3 or 4 numbers on the back of the card. Our API checks to see if the CVC supplied matches the CVC held by the issuing bank.

debtRepaymentboolean

DRI is a flag which identifies a payment as being for the purpose of repaying a debt.

merchantobjectrequired

An object that contains information about the merchant.

entitystringrequired

Direct your payment to assist with billing, reporting and reconciliation. This is mandatory for authentication and queries.

mccstring

You can apply a merchant category code mcc to an individual request. You can only provide an mcc if we have enabled the dynamic mcc feature during boarding. If enabled but not provided, merchant.mcc defaults to a configured value.

paymentFacilitatorobject

An object containing Payment Facilitator information. This information is required for every authorization only if you are a Payment Facilitator.

transactionReferencestringrequired

A unique reference generated by you that is used to identify a payment throughout its lifecycle.

channelstring

The payment channel indicates the interaction of the cardholder with the merchant. Supply a value of moto to process an authorization as a Mail Order or Telephone Order (MOTO) transaction. If channel is not provided, the authorization will be processed as ecommerce by default

Value"moto"
customerobject

An object that contains riskProfile and authentication of the customer.

curl -i -X POST \
  -u undefined:undefined \
  https://try.access.worldpay.com/payments/authorizations \
  -H 'Accept: application/vnd.worldpay.payments-v6.hal+json' \
  -H 'Content-Type: application/vnd.worldpay.payments-v6+json' \
  -d '{
    "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
        }
      }
    }
  }'

Responses

The payment authorization has been successfully created

Bodyapplication/vnd.worldpay.payments-v6.hal+json
outcomestringrequired

Outcome of the request.

Discriminator
exemptionobject

An exemption result and reason if a risk profile was included in your authorization request.

issuerobject

An object containing information returned by the issuer.

paymentInstrumentobject

Details of the paymentInstrument used.

riskFactorsArray of objects

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

schemeobject

An object containing information returned by the scheme.

Response
application/vnd.worldpay.payments-v6.hal+json

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