PATCH
/
reward_templates
/
{reward_template_id}
Patch Reward Template
curl --request PATCH \
  --url https://api.synctera.com/v1/reward_templates/{reward_template_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "amount": 1000,
  "currency": "USD",
  "description": "Referral Reward",
  "internal_account_id": "42943c51-e4ff-4e57-9558-08cab6b963c8",
  "is_enabled": true,
  "metadata": {},
  "subtype": "ACCOUNT_OPENING_BONUS"
}'
{
  "amount": 1000,
  "currency": "USD",
  "description": "Referral Reward",
  "internal_account_id": "42943c51-e4ff-4e57-9558-08cab6b963c8",
  "is_enabled": true,
  "metadata": {},
  "creation_time": "2010-05-06T12:23:34.321Z",
  "id": "85943c51-e4ff-4e57-9558-08cab6b96364",
  "last_updated_time": "2010-05-06T12:23:34.321Z",
  "subtype": "ACCOUNT_OPENING_BONUS",
  "tenant": "abcdef_ghijkl"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
Idempotency-Key
string

An idempotency key is an arbitrary unique value generated by client to detect subsequent retries of the same request. It is recommended that a UUID or a similar random identifier be used as an idempotency key. A different key must be used for each request, unless it is a retry.

Example:

"7d943c51-e4ff-4e57-9558-08cab6b963c7"

Path Parameters

​
reward_template_id
string<uuid>
required

The unique identifier of a reward template

Example:

"64438afd-fa20-4010-a573-2bbdca77cdb6"

Body

application/json
​
amount
integer

The default amount of the reward in ISO 4217 minor currency units, e.g. cents. The internal account will be debited this amount. Can be overridden when creating a reward.

Example:

1000

​
currency
string

currency for the reward, as a three character ISO 4217 alphabetic currency code.

Example:

"USD"

​
description
string

The description of the reward template.

Example:

"Referral Reward"

​
internal_account_id
string<uuid>

The ID of default internal_account to use as the source of the reward transfer. Cannot be a system internal account.

Example:

"42943c51-e4ff-4e57-9558-08cab6b963c8"

​
is_enabled
boolean

Whether the reward template is enabled. If false, rewards cannot be created from this template.

Example:

true

​
metadata
object

Optional field to store additional information about the resource. Intended to be used by the integrator to store non-sensitive data.

​
subtype
enum<string>

A short string representing the sub-type of the reward. This will be used as the subtype of the resulting transaction.

Available options:
ACCOUNT_OPENING_BONUS,
CASHBACK,
INTEREST_RATE_BONUS,
LOAN_INTEREST_RATE_REDUCTION,
MANUAL_ADJUSTMENT,
MILES,
MISCELLANEOUS,
POINTS,
REFERRAL_BONUS

Response

Updated reward template

​
currency
string
required

currency for the reward, as a three character ISO 4217 alphabetic currency code.

Example:

"USD"

​
internal_account_id
string<uuid>
required

The ID of default internal_account to use as the source of the reward transfer. Cannot be a system internal account.

Example:

"42943c51-e4ff-4e57-9558-08cab6b963c8"

​
is_enabled
boolean
required

Whether the reward template is enabled. If false, rewards cannot be created from this template.

Example:

true

​
creation_time
string<date-time>
required

The timestamp representing when the reward template was created

Example:

"2010-05-06T12:23:34.321Z"

​
id
string<uuid>
required

The ID of the reward template.

Example:

"85943c51-e4ff-4e57-9558-08cab6b96364"

​
last_updated_time
string<date-time>
required

The timestamp representing when the reward template was last modified

Example:

"2010-05-06T12:23:34.321Z"

​
subtype
enum<string>
required

A short string representing the sub-type of the reward. This will be used as the subtype of the resulting transaction.

Available options:
ACCOUNT_OPENING_BONUS,
ACCOUNT_OPENING_BONUS_REVERSAL,
CASHBACK,
CASHBACK_REVERSAL,
INTEREST_RATE_BONUS,
INTEREST_RATE_BONUS_REVERSAL,
LOAN_INTEREST_RATE_REDUCTION,
LOAN_INTEREST_RATE_REDUCTION_REVERSAL,
MANUAL_ADJUSTMENT,
MANUAL_ADJUSTMENT_REVERSAL,
MILES,
MILES_REVERSAL,
MISCELLANEOUS,
MISCELLANEOUS_REVERSAL,
POINTS,
POINTS_REVERSAL,
REFERRAL_BONUS,
REFERRAL_BONUS_REVERSAL
​
tenant
string
required

The id of the tenant containing the resource.

Example:

"abcdef_ghijkl"

​
amount
integer

The default amount of the reward in ISO 4217 minor currency units, e.g. cents. The internal account will be debited this amount. Can be overridden when creating a reward.

Example:

1000

​
description
string

The description of the reward template.

Example:

"Referral Reward"

​
metadata
object

Optional field to store additional information about the resource. Intended to be used by the integrator to store non-sensitive data.