Skip to content
APIs/Card Payments/
/
Recurring sale

Recurring sale

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

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
transactionReferencestringrequired

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

merchantobjectrequired

An object that contains information about the merchant.

instructionobjectrequired

An object that contains all information related to the payment.

Recurring 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"
      }
    },
    "intent": "subscription"
  }
}

Responses

The recurring payment 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

Full 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
Response

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
      }
    ]
  }
}