Delete subscriber

Delete a subscriber's saved card, so that it can no longer be charged. The subscriber stays, with its history, and the payer can renew it with a new card.

Request

• {subid} is the subscriber's "id", from seq.

The request has no body. The key needs the charge permission.

Headers

Response

We answer 200 OK with an empty object, {}, once the card is forgotten. What is final is that: we no longer have the card, and can't get it back. The subscriber itself remains:

• Seq returns it with a "delete" in its "acts", and its "rev" one higher.
• Charge subscriber fails with 410 subscriber deleted.
• Renew subscriber works as before: the payer saves a new card, and the subscriber can be charged again, with its old "id".
• Its charges, which are transactions, are not affected: you can still capture, refund, or void them.

Deleting a subscriber that is deleted already changes nothing, and answers 200 OK again, so the request is safe to send again.

Errors

Besides the errors that any request can give, which Errors lists:

When to delete

Delete a subscriber when the payer cancels, and you will not charge them again, or when they ask you to forget their card. Until you do, the card can be charged, and a leaked API key could charge it. See Charging subscribers.