Reward Conversions Management

Note
This feature is currently in beta and subject to change. To learn more about the Beta program for this feature, contact your Marqeta representative.

Use the /credit/rewards/conversions endpoint to manage the reward conversion rates for reward redemptions. Marqeta only manages rewards conversion rates for redemptions managed by the Marqeta Rewards Platform: for example, STATEMENT_CREDIT. The Marqeta Rewards Platform does not manage redemptions in which the rewards balance is redeemed for conversion through a third-party system. Conversions for EXTERNAL-type redemptions are not managed by the Marqeta Rewards Platform either.

Retrieve conversion entries

Action: GET
Endpoint: /credit/rewards/conversions Retrieve conversion entries by reward program short code.

Response body

Fields	Description
count integer Returned	Number of resources returned. Allowable Values: 1–100
start_index integer Returned	Sort order index of the first resource in the returned array. Allowable Values: Any integer
end_index integer Returned	Sort order index of the last resource in the returned array. Allowable Values: Any integer
is_more boolean Conditionally returned	A value of `true` indicates that more unreturned resources exist. Allowable Values: `true`, `false`
data array of objects Returned	List of conversion objects. Allowable Values: Valid array of one or more conversion objects
data[].token string Returned	Unique identifier of the conversion. Allowable Values: 36 char max
data[].bundle_token string Returned	Unique identifier of the bundle. Allowable Values: 36 char max
data[].type string Returned	Type of redemption. - `EXTERNAL` - You issue the redemption on your external platform; Marqeta adjusts the reward account balance on the system of record. - `STATEMENT_CREDIT` - Marqeta issues the redemption as a statement credit on the associated account. NOTE: This creates a new journal entry on the account and cannot be undone. Allowable Values: `EXTERNAL`, `STATEMENT_CREDIT`
data[].conversion_rate decimal Returned	Rate that points are worth when converting them using the `REDEMPTION_TYPE` indicated. Allowable Values: 0.001 min Format: 0.000
data[].conversion_increment integer Returned	Static amount to reward if rule conditions are met. Allowable Values: Any integer
data[].currency string Conditionally returned	Type of currency used for the conversion rate. Three-digit ISO 4217 currency code. Allowable Values: Any currency code allowed by your program
data[].is_active boolean Returned	A value of `true` indicates that the conversion is active. Allowable Values: `true`, `false` Default value:`true`
data[].created_time datetime Returned	Date and time when the conversion entry was created on the Marqeta platform, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ
data[].updated_time datetime Returned	Date and time when the conversion entry was last updated on the Marqeta platform, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ

Sample response body

JSON

{
  "count": 1,
  "start_index": 0,
  "end_index": 0,
  "data": [
    {
      "token": "8a8cfd94-978a-4b03-80e0-ed57be0c6230",
      "type": "STATEMENT_CREDIT",
      "conversion_rate": 1.3,
      "conversion_increment": 130,
      "currency": "USD",
      "is_active": true,
      "bundle_token": "f0cf97cb-76f7-47a5-83e7-188b9e741cf9",
      "created_time": "2024-01-04T20:37:11Z",
      "updated_time": "2024-01-04T20:37:11Z"
    }
  ]
}

Reward Redemptions

Validating Connectivity

⌘I

​Retrieve conversion entries

​Response body

​Sample response body

Retrieve conversion entries

Response body

Sample response body