Skip to main content
POST
Promo Credit Increment

Endpoint Overview

POST https://api.unibee.dev/merchant/credit/promo_credit_increment Increase user promo credit amount

Authorization

All UniBee Merchant API requests require authentication via API key.

Parameters

Parameters for this endpoint are listed below. The schema is also shown in the Try it panel.

Request body


Request examples

cURL

Sandbox


Response

Success responses return a JSON envelope with code, data, message, redirect, and requestId. code 0 indicates success.

Error handling

When code in the response body is non-zero, check message for details. Use requestId when contacting support.

Authorizations

Authorization
string
header
required

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

Body

application/json

Increase user promo credit amount

amount
integer<int64>
required

The amount to increase, should greater than 0

currency
string<string>
required

currency of recharge

userId
integer<int64>
required

filter id of user

description
string<string>

description of increase action

idempotencyKey
string<string>

Optional. Client-supplied idempotency key, max 256 chars (UUID recommended). Retrying the same key returns the original credit transaction and does NOT increase the balance a second time. Reusing the same key with a different amount or currency is rejected. Increment and decrement use separate namespaces and are isolated per merchant and user, so reusing the same key on the decrement endpoint, under another merchant, or for another user does not collide. If two requests with the same key are still in-flight, the later one returns an error and should be retried by the caller.

name
string<string>

name of increase action

Response

200 - application/json
code
integer<int>
data
object
merchantId
integer<int64>
message
string<string>
redirect
string<string>
requestId
string<string>