## Card on File Manadate
The Card on File Mandate is a new set of requirements created by Visa, Mastercard, and Discover for businesses that store cardholder payment information for use in future sales. For more information on the mandate and what constitutes a Card on File, we recommend reading this <a href="https://www.chargebackgurus.com/blog/understanding-the-2018-visa-mastercard-mandate-for-subscription-transactions" target="_blank">article</a>.
Currently only merchants processing on the Worldpay platform are required to add these new properties into their sale request bodies, but all other credit card processors will be implementing the changes soon. We recommend implementing this as soon as possible to ensure your platform is compliant with the card brands.
PaySimple will automatically map the SubmissionType as either initial or subsequent based upon the inclusion of a `
network_transaction_id`, unless `
is_resubmission: true` is used in the request body. The PaySimple Payments API Sandbox has been set up to return a mocked `
network_transaction_id` when `
amount: 5.03` is used along with a Card on File `
sale_type`. The PaySimple Sandbox will return the same value for the `
network_transaction_id` after each subsequent sale. In production this value can be changed by the card brands after each subsequent sale. Only the newest value needs to be retained.
For more information on all of the sale endpoint properties, see our **[Payments API Reference Guide](🔗)**
|sale_type||string||Valid Card on File Values: `|
|network_transaction_id||string||Value returned by the card brand after a successful authorization when a Card on File `|
|is_resubmission||boolean||Overrides the SubmissionType and sets it to resubmission. To be used when attempting to reprocess a Card on File sale after the original transaction was declined due to insufficient funds after goods or services have been delivered.|
## Code Samples
Sample Initial Sale Request:
See our section on <a href="https://documentation.paysimple.com/v2019/docs/payment-method-tokenization-pmt-library" >Payment Method Tokenization</a> (as used above) for more information on vaulting cards for use with Card on File sales.
## Additional Details
|Card on File `||Description|
|on_file_customer_initiated||Used when cardholder agrees to save a card on file to be used for ongoing customer-initiated sales without a regular schedule.|
|on_file_merchant_initiated||Used when cardholder agrees to save a card on file to be used for ongoing merchant-initiated sales without a regular schedule.|
|recurring||A merchant-initiated sale processed with a variable amount over regular intervals.|
|installment||A merchant-initiated sale processed with a fixed amount over fixed period of time.|