From 910853deacab959faff30a304965a4c21ca00f37 Mon Sep 17 00:00:00 2001 From: Ray2126 Date: Tue, 16 Apr 2024 00:33:54 +0000 Subject: [PATCH] =?UTF-8?q?Deploying=20to=20gh-pages=20from=20=20@=203b39b?= =?UTF-8?q?ebddf673453f68c74a4b104cf72601d0850=20=F0=9F=9A=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 404.html | 2 +- api/account-memberships/index.html | 2 +- api/accounts/index.html | 2 +- api/api-keys/index.html | 2 +- api/asset-activities/index.html | 2 +- api/asset-transfers/index.html | 2 +- api/asset-types/index.html | 2 +- api/assets/index.html | 2 +- api/auth/index.html | 2 +- api/bank-account-approvals/index.html | 2 +- .../index.html | 2 +- api/bank-accounts/index.html | 2 +- .../farmlands-external-asset/index.html | 2 +- api/batch-types/ticketek-ticket/index.html | 2 +- .../verifone-terminal-status/index.html | 2 +- api/batches/index.html | 2 +- api/businesses/index.html | 2 +- api/centrapay-event-types/index.html | 2 +- api/data-types/index.html | 2 +- api/events/index.html | 2 +- api/external-assets/index.html | 2 +- api/funds-transfers/index.html | 2 +- api/http-status-codes/index.html | 2 +- api/integration-requests/index.html | 2 +- api/integrations/index.html | 2 +- api/introduction/index.html | 2 +- api/invitations/index.html | 2 +- api/legacy-payment-requests/index.html | 2 +- api/loyalty-program-memberships/index.html | 2 +- api/loyalty-programs/index.html | 2 +- api/managed-integrations/index.html | 2 +- api/media-uploads/index.html | 2 +- api/merchant-configs/index.html | 2 +- api/merchants/index.html | 2 +- api/pagination/index.html | 2 +- api/patron-codes/index.html | 2 +- api/payment-requests/index.html | 2 +- api/profiles/index.html | 2 +- api/promotion-memberships/index.html | 85 +++++++++++++++++++ api/promotions/index.html | 6 +- api/quotas/index.html | 2 +- api/scanned-codes/index.html | 2 +- api/settlements/index.html | 2 +- api/tokens/index.html | 2 +- api/wallets/index.html | 2 +- connections/farmlands/index.html | 2 +- guides/creating-digital-tokens/index.html | 2 +- guides/creating-test-money/index.html | 2 +- guides/ecommerce-website/index.html | 2 +- guides/example-oidc-consumer/index.html | 2 +- .../farmlands-card-partner-support/index.html | 2 +- guides/farmlands-portal/index.html | 2 +- guides/farmlands-pos-integration/index.html | 2 +- guides/initiating-refunds/index.html | 2 +- .../integrating-third-party-asset/index.html | 2 +- guides/line-items/index.html | 2 +- guides/loading-and-sending-assets/index.html | 2 +- .../index.html | 2 +- .../index.html | 2 +- .../index.html | 2 +- guides/partial-payment-extension/index.html | 2 +- guides/patron-not-present/index.html | 2 +- guides/payment-conditions/index.html | 2 +- guides/payment-flows/index.html | 2 +- guides/payment-terminals/index.html | 2 +- guides/point-of-sale/index.html | 2 +- guides/requesting-payment/index.html | 2 +- guides/requesting-pre-auth/index.html | 2 +- .../index.html | 2 +- guides/transaction-reporting/index.html | 2 +- index-data.json | 2 +- index.html | 2 +- 72 files changed, 158 insertions(+), 73 deletions(-) create mode 100644 api/promotion-memberships/index.html diff --git a/404.html b/404.html index 3f52ecce4..132986129 100644 --- a/404.html +++ b/404.html @@ -17,7 +17,7 @@ -
+ + + + +

Promotion Memberships

Promotion Memberships represents an Account’s  API  membership to a Promotion  API . Each Promotion Membership carries progress towards completing the Promotion. Promotion Memberships are created automatically for the account when a Loyalty Program Membership  API  is created.

+
+

Attributes

  • id

    string

    The unique identifier for the Promotion.

  • accountId

    string

    The ID of the Account  API  that owns the Promotion.

  • name

    string

    The display name of the Promotion.

  • programId

    string

    The ID of the Loyalty Program  API  that the Promotion belongs to.

  • description

    string

    The display description for the Promotion.

  • mediaUploadId

    string

    The ID of the Media Upload  API  image of the Promotion.

  • img

    string

    The img URL of the Promotion.

  • startsAt

    timestamp

    The timestamp of when the Promotion starts.

  • endsAt

    timestamp

    The timestamp of when the Promotion ends.

  • rewards

    array

    A list of Rewards  API  that the account will receive upon completing the Promotion.

  • eventType

    string

    The type of Event  API  that will trigger increments and completions of the Promotion.

  • target

    object

    Describes how to complete the promotion. See Promotion Target  API .

  • type

    string

    The type of Promotion. Can be cashback or challenge. challenge rewards the account once, after the challenge target is met. cashback gives a reward based on the payment amount, which can be completed an unlimited number of times.

  • conditions

    array

    The list of Conditions  API  that need to be met when incrementing/completing the Promotion.

  • progress

    number

    The Account’s progress towards completing the Promotion.

  • status

    number

    The status of the Promotion Membership. Can be “active”, “expired”, or “complete”.

  • createdAt

    string

    The timestamp of when the Promotion Membership was created.

  • createdBy

    crn

    The User or API Key that created the Promotion Membership.

  • modifiedAt

    string

    The timestamp of when the Promotion Membership was last modified.

  • modifiedBy

    crn

    The User or API Key that last modified the Promotion Membership.

+
+
GET/api/accounts/{id}/promotion-memberships

Returns a paginated  API  list of Promotion Memberships for an Account  API 

Request
GET/api/accounts/57SyRRgZ1U8Kq2wKpCnSR5/promotion-memberships
curl -X GET \
+ https://service.centrapay.com/api/accounts/57SyRRgZ1U8Kq2wKpCnSR5/promotion-memberships \
+ -H 'x-api-key: <TOKEN>'
Response
{
+  "items": [
+    {
+      "id": "8aoMfscvtuewsuJzmzBzAs",
+      "accountId": "57SyRRgZ1U8Kq2wKpCnSR5",
+      "programId": "WRhAxxWpTKb5U7pXyxQjjY",
+      "name": "Spend a Buck",
+      "description": "Make a payment of $1 or more",
+      "mediaUploadId": "26yUWG6wFgmva8UaDiCTWq",
+      "img": "https://media-upload.centrapay.com/image.png?jhbdsfau67ewejshb=487hsdjhbdgs743",
+      "startsAt": "2023-02-16T00:47:54.131Z",
+      "endsAt": "2024-02-16T00:47:54.131Z",
+      "rewards": [
+        {
+          "assetType": "centrapay.nzd.main",
+          "amount": "500"
+        }
+      ],
+      "eventType": "payment",
+      "target": {
+        "type": "count",
+        "amount": 1
+      },
+      "type": "challenge",
+      "conditions": [
+        {
+          "field": "amount",
+          "value": "99",
+          "operator": "greater-than"
+        }
+      ],
+      "createdAt": "2023-02-08T04:04:27.426Z",
+      "createdBy": "crn::user:1234",
+      "modifiedAt": "2023-02-08T04:04:27.426Z",
+      "modifiedBy": "crn::user:1234",
+      "progress": 0,
+      "status": "active"
+    }
+  ]
+}
\ No newline at end of file diff --git a/api/promotions/index.html b/api/promotions/index.html index d0117e7dc..e89440c40 100644 --- a/api/promotions/index.html +++ b/api/promotions/index.html @@ -19,7 +19,7 @@

Promotions

Promotions are a mechanism to reward accounts for completing certain actions.

+

Promotions

Promotions are a mechanism to reward accounts for completing certain actions.

Attributes

  • id

    string

    The unique identifier for the Promotion.

  • accountId

    string

    The ID of the Account  API  that owns the Promotion.

  • name

    string

    The display name of the Promotion.

  • programId

    string

    The ID of the Loyalty Program  API  that the Promotion belongs to.

  • description

    string

    The display description for the Promotion.

  • mediaUploadId

    string

    The ID of the Media Upload  API  image of the Promotion.

  • img

    string

    The img URL of the Promotion.

  • startsAt

    timestamp

    The timestamp of when the Promotion starts.

  • endsAt

    timestamp

    The timestamp of when the Promotion ends.

  • rewards

    array

    A list of Rewards  API  that the account will receive upon completing the Promotion.

  • eventType

    string

    The type of Event  API  that will trigger increments and completions of the Promotion.

  • target

    object

    Describes how to complete the promotion. See Promotion Target  API .

  • type

    string

    The type of Promotion. Can be cashback or challenge. challenge rewards the account once, after the challenge target is met. cashback gives a reward based on the payment amount, which can be completed an unlimited number of times.

  • conditions

    array

    The list of Conditions  API  that need to be met when incrementing/completing the Promotion.

+
  • id

    string

    The unique identifier for the Promotion.

  • accountId

    string

    The ID of the Account  API  that owns the Promotion.

  • name

    string

    The display name of the Promotion.

  • programId

    string

    The ID of the Loyalty Program  API  that the Promotion belongs to.

  • description

    string

    The display description for the Promotion.

  • mediaUploadId

    string

    The ID of the Media Upload  API  image of the Promotion.

  • img

    string

    The img URL of the Promotion.

  • startsAt

    timestamp

    The timestamp of when the Promotion starts.

  • endsAt

    timestamp

    The timestamp of when the Promotion ends.

  • rewards

    array

    A list of Rewards  API  that the account will receive upon completing the Promotion.

  • eventType

    string

    The type of Event  API  that will trigger increments and completions of the Promotion.

  • target

    object

    Describes how to complete the promotion. See Promotion Target  API .

  • type

    string

    The type of Promotion. Can be cashback or challenge. challenge rewards the account once, after the challenge target is met. cashback gives a reward based on the payment amount, which can be completed an unlimited number of times.

  • conditions

    array

    The list of Conditions  API  that need to be met when incrementing/completing the Promotion.

  • createdAt

    string

    The timestamp of when the Promotion was created.

  • createdBy

    crn

    The User or API Key that created the Promotion.

Attributes