younifyd
Menu

Delete Loyalty Transactions From Ledgers

Delete customer's transactions from loyalty ledgers

POST/v1/loyalty_programs/{loyaltyProgramId}/profile/{integrationId}/delete_transactions

Use it in a workflow

  1. Add a step and choose the Talon.One connector.
  2. Pick the Delete Loyalty Transactions From Ledgers action (under integration).
  3. Fill in the fields below, then reference the result from later steps as {{deleteLoyaltyTransactionsFromLedgers.response.data}}.

Request

Path parameters

loyaltyProgramIdinteger (int64)required

Identifier of the profile-based loyalty program. You can get the ID with the [List loyalty programs](https://docs.talon.one/management-api#tag/Loyalty/operation/getLoyaltyPrograms) endpoint.

integrationIdstringrequired

The integration ID of the customer profile. You can get the `integrationId` of a profile using: - A customer session integration ID with the [Update customer session](https://docs.talon.one/integration-api#tag/Customer-sessions/operation/updateCustomerSessionV2) endpoint. - The Management API with the [List application's customers](https://docs.talon.one/management-api#tag/Customer-data/operation/getApplicationCustomers) endpoint.

Request body

Enter the body as JSON in the step's Body field.

scopestringrequired

`AllSubledgers` deletes all transactions for the specified customer profile from all ledgers in the loyalty program. `SelectedSubledgers` deletes all transactions for the specified customer profile only from the given ledgers in the loyalty program.

One ofAllSubledgersSelectedSubledgers

subledgerIdsarray<string>

The IDs of the ledgers from which to delete the customer's transactions. This parameter is required if the `scope` is set to `SelectedSubledgers`. To specify the main ledger, provide an empty string ("").

json
{
  "scope": "SelectedSubledgers",
  "subledgerIds": [
    "subledger1",
    "subledger2"
  ]
}

Response

Returns 204 with a any. Read it in later steps with {{deleteLoyaltyTransactionsFromLedgers.response.data.<field>}}.

Need more? See the Talon.One guide for connection setup and behaviour shared by every action.