Paginate Customer Credit History

curl --request GET 'https://api.mayar.id/hl/v2/credit/customer/paginate-credit-history/a1b2c3d4-e5f6-4789-a012-3456789abcde?productId=7c9d2e1f-4a5b-4c6d-8e9f-0a1b2c3d4e5f&page=1&limit=10' \
--header 'Authorization: Bearer Paste-Your-API-Key-Here'

{
    "statusCode": 200,
    "messages": "success",
    "data": [
        {
            "id": "f1e2d3c4-b5a6-4789-9012-3456789abcdef",
            "datetime": "2026-06-20T09:10:57.994Z",
            "type": "CREDIT_USAGE",
            "amount": 10000,
            "balanceBefore": 60000,
            "balanceAfter": 50000,
            "walletType": "MAIN",
            "description": "Credit usage for product order",
            "customerId": "a1b2c3d4-e5f6-4789-a012-3456789abcde",
            "productId": "7c9d2e1f-4a5b-4c6d-8e9f-0a1b2c3d4e5f"
        },
        {
            "id": "a1b2c3d4-e5f6-4789-9012-3456789abcdef",
            "datetime": "2026-06-19T15:30:00.000Z",
            "type": "MERCHANT_TOPUP",
            "amount": 50000,
            "balanceBefore": 10000,
            "balanceAfter": 60000,
            "walletType": "ADD_ON",
            "description": "Merchant top-up",
            "customerId": "a1b2c3d4-e5f6-4789-a012-3456789abcde",
            "productId": "7c9d2e1f-4a5b-4c6d-8e9f-0a1b2c3d4e5f"
        }
    ],
    "metadata": {
        "page": 1,
        "limit": 10,
        "totalPages": 1,
        "totalData": 2
    }
}

curl --request GET 'https://api.mayar.id/hl/v2/credit/customer/paginate-credit-history/a1b2c3d4-e5f6-4789-a012-3456789abcde?productId=7c9d2e1f-4a5b-4c6d-8e9f-0a1b2c3d4e5f&page=1&limit=10' \
--header 'Authorization: Bearer Paste-Your-API-Key-Here'

{
    "statusCode": 200,
    "messages": "success",
    "data": [
        {
            "id": "f1e2d3c4-b5a6-4789-9012-3456789abcdef",
            "datetime": "2026-06-20T09:10:57.994Z",
            "type": "CREDIT_USAGE",
            "amount": 10000,
            "balanceBefore": 60000,
            "balanceAfter": 50000,
            "walletType": "MAIN",
            "description": "Credit usage for product order",
            "customerId": "a1b2c3d4-e5f6-4789-a012-3456789abcde",
            "productId": "7c9d2e1f-4a5b-4c6d-8e9f-0a1b2c3d4e5f"
        },
        {
            "id": "a1b2c3d4-e5f6-4789-9012-3456789abcdef",
            "datetime": "2026-06-19T15:30:00.000Z",
            "type": "MERCHANT_TOPUP",
            "amount": 50000,
            "balanceBefore": 10000,
            "balanceAfter": 60000,
            "walletType": "ADD_ON",
            "description": "Merchant top-up",
            "customerId": "a1b2c3d4-e5f6-4789-a012-3456789abcde",
            "productId": "7c9d2e1f-4a5b-4c6d-8e9f-0a1b2c3d4e5f"
        }
    ],
    "metadata": {
        "page": 1,
        "limit": 10,
        "totalPages": 1,
        "totalData": 2
    }
}

Endpoint:

https://api.mayar.id/hl/v2/credit/customer/paginate-credit-history/(customerId)?productId=(productId)&page=1&limit=10

https://api.mayar.io/hl/v2/credit/customer/paginate-credit-history/(customerId)?productId=(productId)&page=1&limit=10

Authorization

string

required

Example:Authorization | Bearer Paste-Your-API-Key-Here

Path Parameters

string

required

The unique identifier of the customer whose credit history you want to retrieve.

Query Parameters

string

required

The unique identifier of the product to filter credit history by.

string

The unique identifier of the membership tier to filter by.

integer

default:"1"

Page number for pagination.

integer

default:"10"

Number of records per page.

string

default:"datetime"

Field to sort by (for example datetime, amount).

string

default:"desc"

Sort order: asc or desc.

string

Start date filter (ISO 8601 format).

string

End date filter (ISO 8601 format).

string

Filter by wallet type: MEMBERSHIP, ADD_ON, or MAIN.

string

Filter by transaction type: TOPUP, MERCHANT_TOPUP, TRIAL_TOPUP, EXPIRE_VOID, CREDIT_USAGE.

Response

Successful Response

Main Structure (Root)

integer

Status code from the API.

string

Status message that describes the status code.

array of object

Array of credit transaction records.

object

Pagination metadata containing page, limit, totalPages, and totalData.

data Structure (Array Of Object)

string<uuid>

Unique identifier of the credit transaction.

string

ISO 8601 timestamp (UTC) of the transaction.

string

Transaction type: TOPUP, MERCHANT_TOPUP, TRIAL_TOPUP, EXPIRE_VOID, or CREDIT_USAGE.

integer

The amount of credit involved in the transaction.

integer

Customer balance before the transaction.

integer

Customer balance after the transaction.

string

Wallet type affected: MAIN, MEMBERSHIP, or ADD_ON.

string

Description of the transaction.

string<uuid>

Customer identifier associated with the transaction.

string<uuid>

Product identifier associated with the transaction.

Errors

object

Returned when required parameters are missing or fail validation.

object

Returned when the specified customer is not found.

API documentation

Products & payment links

Invoice

Payments

QR / Payment Channels

Transaction

Customer

Membership

Balances

Installment

Discount & Coupon

Bundling

Webhook

Reviews

Credit (Membership / Usage)

SaaS Subscription License

Software License

Authorization

Path Parameters

Query Parameters

Response

Main Structure (Root)

data Structure (Array Of Object)

Errors

​Authorization

​Path Parameters

​Query Parameters

​Response

​Main Structure (Root)

​data Structure (Array Of Object)

​Errors

Authorization

Path Parameters

Query Parameters

Response

Main Structure (Root)

data Structure (Array Of Object)

Errors