Redemption Feed

Abstract

This document describes the structure and delivery of the Redemption Feed, a data file provided by CDLX to partners. The feed contains anonymized transaction records with details such as transaction ID, cardholder ID, merchant and offer identifiers, store information, merchant name, card type, card last four digits (if available), transaction amount, and transaction timestamp. All fields are required except for card type and last four digits, which are included if available. CDLX uploads the Redemption Feed files hourly, and partners retrieve them via SFTP.

Redemption Feed

Field Name	Data Type	Nullable	Note
transaction_id	String	No	Unique transaction ID, anonymized and obfuscated on CDLX side per Partner
cardholder_id	String	No	Unique cardholder ID, anonymized and obfuscated on CDLX side per Partner
partner_merchant_id	String	No	Partner provided merchant identifier
partner_offer_id	String	No	Partner provided offer identifier
partner_store_id	String	No	Partner provided store identifier
partner_merchant_name	String	No	Partner provided merchant name
card_type	String (Visa, Mastercard)	Yes	Card Network (if available)
card_last_four	String	Yes	The cardholder’s last 4 digits of the card (if available)
transaction_amount	Number	No	Transaction amount
transaction_timestamp	String (ISO 8601 format)	No	Transaction timestamp (when the transaction occurred)

Note the following:

CDLX will upload this file on an hourly cadence.
Partners will use SFTP to pull these files.