Create Wallet - API Documentation

This API is used to create a wallet that will be used as a place to store balances.

The balance can be received from the Payin transaction process, Payout will also be taken from the wallet, and settlement is also done through the wallet.

Each POST/PATCH Request requires a Signature in the header, you can follow the following code to create the Signature:

const signature = cryptoJs.HmacSHA256(
    cryptoJs.enc.Utf8.parse(JSON.stringfy(body)),
    cryptoJs.enc.Utf8.parse(signatureKey)
).toString();

Request

Header Params

X-token

string

required

signature

string

required

Hash your string payload request using SHA256, and use your SignatureKey as key

Body Params application/json

string

customer_id

string

required

currency

string

required

currency_list

array[string]

required

description

string

optional

webhook_url

string

optional

Example

{
  "customer_id": "string",
  "currency": "string",
  "currency_list": [
    "string"
  ],
  "description": "string",
  "webhook_url": "string"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Body

status

boolean

required

message

string

required

data

object

required

category

string

required

created_at

string

required

customer_id

string

required

deleted_at

string

required

description

string

required

is_active

boolean

required

is_deleted

boolean

required

metadata

object

required

org_id

string

required

raw_data

string

required

scope

string

required

updated_at

string

required

wallet_account

array [object {12}]

required

wallet_alias

string

required

wallet_id

string

required

webhook_url

string

required

Examples

SuccessException

{
  "status": true,
  "message": "string",
  "data": {
    "category": "string",
    "created_at": "2025-02-13T02:33:58.035Z",
    "customer_id": "string",
    "deleted_at": "2025-02-13T02:33:58.035Z",
    "description": "string",
    "is_active": true,
    "is_deleted": true,
    "metadata": {},
    "org_id": "string",
    "raw_data": "string",
    "scope": "string",
    "updated_at": "2025-02-13T02:33:58.035Z",
    "wallet_account": [
      {
        "actual_balance": 0,
        "available_balance": 0,
        "created_at": "2025-02-13T02:33:58.035Z",
        "currency": "string",
        "deleted_at": "2025-02-13T02:33:58.035Z",
        "is_active": true,
        "is_deleted": true,
        "is_settlement_allowed": true,
        "org_id": "string",
        "updated_at": "2025-02-13T02:33:58.035Z",
        "wallet_account_id": "string",
        "wallet_id": "string"
      }
    ],
    "wallet_alias": "string",
    "wallet_id": "string",
    "webhook_url": "string"
  }
}

🟠400Bad Request