Delete Card

This request permanently deletes the associated subscriptionToken from the customer’s saved payment methods.

Common use: allow customers to manage or remove expired or unwanted payment cards from their Super Wallet profile.

Endpoint

POST https://secure.3gdirectpay.com/API/v6/

Headers

Content-Type: application/xml; charset=utf-8
Accept: application/xml

Request

Required Fields

Field	Type	Req	Description
`Request`	string	Yes	Must be `deleteCard`
`CompanyToken`	string	Yes	Token provided by DPO to authorize API operations
`customerToken`	string	Yes	Customer token retrieved from `createAccount`
`subscriptionToken`	string	Yes	Existing subscription token identifying the card to delete

Example Request (XML)

<?xml version="1.0" encoding="utf-8"?>
<API3G>
  <CompanyToken>68B90B5E-25F6-4146-8AB1-C7A3A0C41A7F</CompanyToken>
  <Request>deleteCard</Request>
  <customerToken>E6C04D7E-C267-4243-BD1C-49170F8A008B</customerToken>
  <subscriptionToken>65F91D6E-E8A9-4BDA-9481-35432F581F3E</subscriptionToken>
</API3G>

Use this request when a card expires, is replaced, or the customer wishes to revoke authorization.

Response

Example Success Response (XML)

<?xml version="1.0" encoding="utf-8"?>
<API3G>
  <Result>000</Result>
  <ResultExplanation>Card been deleted</ResultExplanation>
</API3G>

Field Reference

Field	Type	Description
`Result`	integer	Response code returned by the API
`ResultExplanation`	string	Description of the operation result

Result Codes

Code	ResultExplanation	Meaning / Action
`000`	Card been deleted	Card deleted successfully
`803`	Invalid or missing `Request` name	Ensure `deleteCard`
`888`	System error	Retry or contact support
`902`	Data mismatch	Verify `customerToken` and `subscriptionToken`
`950`	Missing mandatory fields	Check XML for missing tags
`991`	Encrypted string empty	Request formatting issue
`999`	Customer not found	Ensure valid Super Wallet account

Typical Usage Flow

sequenceDiagram
  participant M as Merchant
  participant D as DPO API

  M->>D: deleteCard<br/>(CompanyToken, customerToken, subscriptionToken)
  D-->>M: Result 000 + Card been deleted
  M->>M: Remove card reference from stored customer options
  Note over M,D: Customer’s card is permanently deleted from Super Wallet

Notes & Best Practices

Permanent deletion: Once deleted, the subscriptionToken cannot be reused — a new card must be added via addCard.
Customer control: Ideal for “Manage Payment Methods” or “Delete Card” features in your merchant portal.
Security: Tokens act as payment credentials; ensure deletion requests are authenticated and authorized.
Error handling:
- 000 → Success — card deleted.
- 999 → Customer or card not found — confirm tokens.
- 950 → Missing fields — review XML structure.
Compliance: Always ensure deletions are initiated by the customer or via a verified admin process.