Manage Transfer

Overview

As a Merchant, you can manage your transfers by fetching lists and getting detailed information.

List Transfers

Request :

Endpoint : /v1/merchant-transfers

HTTP Method : GET

Header :

Authorization: Basic ENCODED_KEY

ENCODED_KEY value is result of Base64Encode("apiKey"+":"+"secretKey")

Params :

page : Current Page (Default : 1 ) perPage : Limit on Per Page (Default : 10)

Response :

Sample Success Response :

HTTP Status Code : 200

{
  "data": [
    {
      "id": "5294eb23-29b5-46cc-a577-e6da6a8859a3",
      "slug": "WDW-220325170-UFSCEE",
      "externalId": "ECOMM_00123456",
      "status": "CONFIRMED",
      "amount": 11,
      "fee": 1,
      "receivedAmount": 10,
      "confirmedAt": "2022-03-25T08:54:35.530Z",
      "currencyCode": "USDT",
      "paymentType": "BALANCE",
      "createdAt": "2022-03-25T08:52:31.733Z",
      "updatedAt": "2022-03-25T08:54:35.542Z"
    },
    {
      "id": "1213440d-40e2-4201-820b-f7c6e6e1112b",
      "slug": "WDW-220325189-IWSFAF",
      "externalId": "ECOMM_00123455",
      "status": "CONFIRMED",
      "amount": 200,
      "fee": 12,
      "receivedAmount": 212,
      "confirmedAt": "2022-03-25T09:32:44.508Z",
      "currencyCode": "JST",
      "paymentType": "BALANCE",
      "createdAt": "2022-03-25T09:30:30.086Z",
      "updatedAt": "2022-03-25T09:32:44.517Z"
    }
  ],
  "meta": {
    "page": 1,
    "perPage": 10,
    "totalData": 2,
    "message": "Successfully Get List Withdrawals",
    "statusCode": 200,
    "totalPage": 1
  }
}  

Response JSON Body Details :

Property	Description
id	Transfer ID
slug	Reference ID
externalId	Unique identifier for your transfer
status	Status Withdrawal
amount	The amount that reduces your balance
fee	Transaction fee
receivedAmount	Received Amount
confirmedAt	Timestamp Confirmed Withdrawal on Blockchain
currencyCode	Cryptocurrency code
paymentType	Withdrawal with Balance Payment
createdAt	Timestamp withdrawal created
updatedAt	TImestamp withdrawal updated

Detail Transfers

Request :

Endpoint : /v1/merchant-transfers/:id

HTTP Method : GET

Header :

Authorization: Basic ENCODED_KEY

ENCODED_KEY value is result of Base64Encode("apiKey"+":"+"secretKey")

Response :

Sample Success Response :

HTTP Status Code : 200

{
  "data": {
    "id": "5294eb23-29b5-46cc-a577-e6da6a8859a3",
    "slug": "WDW-220325170-UFSCEE",
    "externalId": "ECOMM_00123455",
    "status": "CONFIRMED",
    "amount": 20,
    "fee": 20,
    "receivedAmount": 19.99,
    "confirmedAt": "2022-03-25T08:54:35.530Z",
    "currencyCode": "TRX",
    "paymentType": "BALANCE",
    "transaction": {
      "id": "006bbfbd-b48f-4da2-9f1d-b3dec5f8c6c7",
      "blockchainCode": "TRON",
      "type": "WITHDRAWAL_MERCHANT",
      "txId": "b5831a9540f732be06180566d5f73772ddc7a369d4d1d267ee053251c2f92000",
      "payCurrency": "TRX",
      "reference": "WDW-220325170-UFSCEE",
      "amount": "20000000.0000",
      "netAmount": "19990000.0000",
      "status": "CONFIRMED",
      "fromAddress": [
        "TT6STC2L4yyAP9CypNQajuQJRpjjjPqmgf"
      ],
      "toAddress": "TAUsbjxkQYJLi5MxS9NqnNXd7ZYnTqUbwj",
      "details": {
        "confirmedAt": "2022-03-25T08:54:35.513Z"
      },
      "confirmedAt": "2022-03-25T08:54:35.513Z",
      "createdAt": "2022-03-25T08:52:31.733Z",
      "updatedAt": "2022-03-25T08:54:35.518Z"
    },
    "createdAt": "2022-03-25T08:52:31.733Z",
    "updatedAt": "2022-03-25T08:54:35.542Z"
  },
  "meta": {
    "message": "Successfully Get Detail Withdrawal",
    "statusCode": 200
  }
}

Response JSON Body Details :

Property	Description
id	Transfer ID
slug	Reference ID
externalId	Unique identifier for your transfer
status	Transfer Status
amount	Amount that reduces your balance
fee	Transaction fee
receivedAmount	Received amount
confirmedAt	Timestamp confirmed transfer on blockchain
currencyCode	Cryptocurrency code
paymentType	Transfer Payment Type
createdAt	Timestamp transfer created
updatedAt	Timestamp withdrawal updated