Recurring sale using card on file

Request

Use our recurring sale resource to authorize and settle merchant initiated transactions where you have stored the card details. You must verify your customer's account before submitting your first recurring payment for authorization.

Security

BasicAuth

Path

linkDatastringrequired

Action link that's received in your request

Content-Typestringrequired

Example:application/vnd.worldpay.payments-v5+json

Acceptstring

Example:application/vnd.worldpay.payments-v5.hal+json

Bodyapplication/vnd.worldpay.payments-v5+json

transactionReferencestringrequired

merchantobjectrequired

instructionobjectrequired

An example of a payment sale with all optional fields

{
  "transactionReference": "transaction-ref",
  "merchant": {
    "entity": "an-entity",
    "mcc": "1234",
    "paymentFacilitator": {
      "pfId": "12345",
      "isoId": "12345",
      "subMerchant": {
        "name": "Merchant Plc",
        "merchantId": "12345",
        "postalCode": "SW1 1AA",
        "street": "Regent Street",
        "city": "London",
        "countryCode": "123",
        "taxId": "12345",
        "state": "St8"
      }
    }
  },
  "instruction": {
    "debtRepayment": true,
    "narrative": {
      "line1": "trading name",
      "line2": "order number"
    },
    "value": {
      "currency": "GBP",
      "amount": 250
    },
    "paymentInstrument": {
      "type": "card/plain",
      "cardNumber": "4444333322221111",
      "cardExpiryDate": {
        "month": 12,
        "year": 2024
      },
      "cardHolderName": "John Appleseed",
      "billingAddress": {
        "address1": "address line 1",
        "address2": "address line 2",
        "address3": "address line 3",
        "city": "city",
        "state": "state",
        "postalCode": "12345",
        "countryCode": "IT"
      }
    }
  }
}

Responses

The recurring payment 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 sale with all optional fields

{
  "outcome": "authorized",
  "issuer": {
    "authorizationCode": "012345"
  },
  "riskFactors": [
    {
      "type": "cvc",
      "risk": "not_matched"
    },
    {
      "type": "avs",
      "detail": "postcode",
      "risk": "not_checked"
    }
  ],
  "_links": {
    "payments:refund": {
      "href": "/payments/settlements/refunds/:linkData"
    },
    "payments:partialRefund": {
      "href": "/payments/settlements/refunds/partials/:linkData"
    },
    "payments:reversal": {
      "href": "/payments/sales/reversals/linkData"
    },
    "payments:events": {
      "href": "/payments/events/linkData"
    },
    "curies": [
      {
        "name": "payments",
        "href": "/rels/payments/{rel}",
        "templated": true
      }
    ]
  }
}