Authorize using card on file, no verification

Request

Use our card on file authorize resource when your customer is initiating a payment using stored card details (without verifying their account first)

Security

BasicAuth

Bodyapplication/vnd.worldpay.payments-v5+json

instructionobjectrequired

merchantobjectrequired

transactionReferencestringrequired

channelstring

Value:"moto"

customerobject

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 authorization for migrated Card On File has been successfully created

Bodyapplication/vnd.worldpay.payments-v5.hal+json

outcomestringrequired

issuerobject

paymentInstrumentobject

riskFactorsArray of objects

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

schemeobject

Response

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"
    },
    "payments:cardOnFileAuthorize": {
      "href": "/payments/cardOnFile/linkData"
    },
    "payments:recurringAuthorize": {
      "href": "/payments/recurring/linkData"
    },
    "curies": [
      {
        "name": "payments",
        "href": "/rels/payments/{rel}",
        "templated": true
      }
    ]
  }
}