Register Membership Customer

curl --request POST 'https://api.mayar.id/hl/v2/credit/membership/customer/regist' \
--header 'Authorization: Bearer Paste-Your-API-Key-Here' \
--header 'Content-Type: application/json' \
--data-raw '{
    "productId": "7c9d2e1f-4a5b-4c6d-8e9f-0a1b2c3d4e5f",
    "membershipTierId": "9b2d4f6a-8c1e-4a3b-bd5c-6e7f8a9b0c1d",
    "customerInfo": {
        "name": "Budi Santoso",
        "email": "budi.santoso@example.com",
        "mobile": "081234567890"
    },
    "trialCredit": 50000,
    "membershipMonthlyPeriod": 1
}'

{
    "statusCode": 201,
    "message": "success",
    "data": {
        "membershipCustomer": {
            "id": "c4d5e6f7-a8b9-4c0d-8e1f-2a3b4c5d6e7f",
            "memberId": "MBR8X2QK",
            "userId": "348e083d-315a-4e5c-96b1-5a2a98c48413",
            "customerId": "a1b2c3d4-e5f6-4789-a012-3456789abcde",
            "membershipTierId": "9b2d4f6a-8c1e-4a3b-bd5c-6e7f8a9b0c1d",
            "paymentLinkId": "7c9d2e1f-4a5b-4c6d-8e9f-0a1b2c3d4e5f",
            "monthlyPaymentPeriod": 1,
            "status": "active",
            "nextPayment": "2026-08-20T09:10:57.994Z",
            "expiredAt": null,
            "createdAt": "2026-07-20T09:10:57.994Z",
            "updatedAt": "2026-07-20T09:10:57.994Z"
        },
        "paymentLink": "https://web.mayar.id/pay-membership/MBR8X2QK"
    }
}

curl --request POST 'https://api.mayar.id/hl/v2/credit/membership/customer/regist' \
--header 'Authorization: Bearer Paste-Your-API-Key-Here' \
--header 'Content-Type: application/json' \
--data-raw '{
    "productId": "7c9d2e1f-4a5b-4c6d-8e9f-0a1b2c3d4e5f",
    "membershipTierId": "9b2d4f6a-8c1e-4a3b-bd5c-6e7f8a9b0c1d",
    "customerInfo": {
        "name": "Budi Santoso",
        "email": "budi.santoso@example.com",
        "mobile": "081234567890"
    },
    "trialCredit": 50000,
    "membershipMonthlyPeriod": 1
}'

{
    "statusCode": 201,
    "message": "success",
    "data": {
        "membershipCustomer": {
            "id": "c4d5e6f7-a8b9-4c0d-8e1f-2a3b4c5d6e7f",
            "memberId": "MBR8X2QK",
            "userId": "348e083d-315a-4e5c-96b1-5a2a98c48413",
            "customerId": "a1b2c3d4-e5f6-4789-a012-3456789abcde",
            "membershipTierId": "9b2d4f6a-8c1e-4a3b-bd5c-6e7f8a9b0c1d",
            "paymentLinkId": "7c9d2e1f-4a5b-4c6d-8e9f-0a1b2c3d4e5f",
            "monthlyPaymentPeriod": 1,
            "status": "active",
            "nextPayment": "2026-08-20T09:10:57.994Z",
            "expiredAt": null,
            "createdAt": "2026-07-20T09:10:57.994Z",
            "updatedAt": "2026-07-20T09:10:57.994Z"
        },
        "paymentLink": "https://web.mayar.id/pay-membership/MBR8X2QK"
    }
}

Endpoint:

https://api.mayar.id/hl/v2/credit/membership/customer/regist

https://api.mayar.io/hl/v2/credit/membership/customer/regist

Authorization

string

required

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

Request Body

string

required

The unique identifier of the membership product.

string

The unique identifier of the membership tier to enroll the customer in.

object

required

The customer’s contact details.

string

required

The customer’s full name (3-250 characters).

string

required

The customer’s email address (6-55 characters).

string

required

The customer’s mobile phone number (10-15 characters).

integer

Optional trial credit amount to grant to the customer upon registration.

integer

required

The monthly billing period for the membership. Accepted values: 1, 3, 6, 12.

Response

Successful Response — HTTP 201

Main Structure (Root)

integer

Status code from the API. 201 on successful registration.

string

Status message (singular — write endpoints use message).

object

The registration result wrapper.

object

The newly created membership customer record.

string

The checkout URL for the member’s first payment.

Errors

object

Returned when the request body fails validation.

object

Returned when a customer with this email is already registered on this tier.

object

Returned when the membership tier has reached its maximum member limit.

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

Request Body

Response

Main Structure (Root)

Errors

​Authorization

​Request Body

​Response

​Main Structure (Root)

​Errors

Authorization

Request Body

Response

Main Structure (Root)

Errors