Create Wallet Transaction

post

https://platform.nector.io/api/v2/merchant/wallettransactions

Credit (cr) or debit (dr) coins in the wallet of the user directly. Prefer Reward Using Trigger for earning use cases so that the earning rules configured on the dashboard are applied, use this API for manual adjustments, migrations or custom earning logic that lives in your backend. Pass hash to make the call idempotent, a retry with the same hash returns the existing transaction instead of crediting twice. This API can be called only with a write access api key, so call it only from your backend. DO NOT EXPOSE THE WRITE ACCESS API KEY IN A BROWSER OR APP

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

lead_id

string

(One of leadid, customer_id is required) (This needs to be leads id value)

customer_id

string

(One of lead_id, customer_id is required) (Minimum length is 8) (Maximum length is 128) (This needs to be leads customer_id value)

title

string

required

(Required) (This needs to be wallettransaction title)

description

string

(This needs to be wallettransaction description)

amount

number

required

(Required) (Minimum is 1) (This needs to be the coin amount)

hash

string

(Maximum length is 64) (Your own reference for this transaction, ex. your order id) (Acts as an idempotency key, if a transaction with the same hash already exists nothing is created and the existing transaction is returned with success false) (Can later be used to filter transactions)

operation

string

enum

required

(Required) (This needs to be wallettransaction operation value) (This can only be one of cr,dr) (cr credits coins to the wallet, dr debits coins from the wallet)

Allowed:

Headers

x-source

string

enum

required

(Required) (This can only be one of mobile,web) (web for browsers and servers, mobile for native apps)

Allowed:

x-apikey

string

required

(Required) (This needs to be your apikey)

x-workspaceid

string

required

(Required) (This needs to be your workspaceid)

Responses

200200

5XXUnexpected error on our side. Retry with backoff and share meta.request_id with [email protected] if it persists