Morapay Developer Docs

Products group reusable catalog items. Each product can spawn payment links with shared branding and metadata. Base path: /api/v1/merchant/products

Endpoints

Method	Path	Description
`GET`	`/products`	List products
`GET`	`/products/:id`	Get product
`POST`	`/products`	Create product
`PATCH`	`/products/:id`	Update product
`GET`	`/products/:id/links`	List links for product
`POST`	`/products/:id/links`	Create link under product
`POST`	`/products/image`	Upload product image

List products

GET /api/v1/merchant/products

Query	Description
`page`, `limit`	Pagination
`q`	Search name or SKU
`status`	Filter by status
`type`	Product type filter
`includeArchived`	`1` to include archived

curl -s "https://api.morapay.io/api/v1/merchant/products?page=1&limit=20" \
  -H "Morapay-Key: $MORAPAY_PUBLIC_KEY" \
  -H "Morapay-Timestamp: $TIMESTAMP" \
  -H "Morapay-Signature: v1=$SIGNATURE"

200 OK

{
  "success": true,
  "data": [
    {
      "id": "product_uuid",
      "name": "Pro plan",
      "currency": "USD",
      "price": 49,
      "isArchived": false
    }
  ],
  "meta": { "page": 1, "limit": 20, "total": 1 }
}

401 Unauthorized

{
  "success": false,
  "error": "Invalid API key.",
  "code": "auth.keys.invalid",
  "requestId": "req_prod401"
}

Get product

GET /api/v1/merchant/products/:id

curl -s "https://api.morapay.io/api/v1/merchant/products/product_uuid" \
  -H "Morapay-Key: $MORAPAY_PUBLIC_KEY" \
  -H "Morapay-Timestamp: $TIMESTAMP" \
  -H "Morapay-Signature: v1=$SIGNATURE"

200 OK

{
  "success": true,
  "data": {
    "id": "product_uuid",
    "name": "Pro plan",
    "price": 49,
    "currency": "USD"
  }
}

404 Not Found

{
  "success": false,
  "error": "Product not found.",
  "code": "resource.not_found",
  "requestId": "req_prod404"
}

Create product

POST /api/v1/merchant/products

Field	Type	Required	Description
`name`	string	Yes	Product name
`description`	string	No	Long description
`price`	number	No	Default price
`currency`	string	No	Default currency
`type`	string	No	Product type
`metadata`	object	No	Custom fields

curl -s -X POST "https://api.morapay.io/api/v1/merchant/products" \
  -H "Content-Type: application/json" \
  -H "Morapay-Key: $MORAPAY_PUBLIC_KEY" \
  -H "Morapay-Timestamp: $TIMESTAMP" \
  -H "Morapay-Signature: v1=$SIGNATURE" \
  -d '{
    "name": "Pro plan",
    "price": 49,
    "currency": "USD"
  }'

201 Created

{
  "success": true,
  "data": {
    "id": "product_uuid",
    "name": "Pro plan",
    "currency": "USD",
    "price": 49,
    "isArchived": false
  }
}

400 Bad Request

{
  "success": false,
  "error": "Validation failed",
  "code": "request.invalid",
  "details": { "fieldErrors": { "name": ["Required"] } },
  "requestId": "req_prod_val"
}

403 Forbidden

{
  "success": false,
  "error": "Complete KYB before creating LIVE products.",
  "code": "kyb.forbidden",
  "requestId": "req_prod403"
}

Update product

PATCH /api/v1/merchant/products/:id

curl -s -X PATCH "https://api.morapay.io/api/v1/merchant/products/product_uuid" \
  -H "Content-Type: application/json" \
  -H "Morapay-Key: $MORAPAY_PUBLIC_KEY" \
  -H "Morapay-Timestamp: $TIMESTAMP" \
  -H "Morapay-Signature: v1=$SIGNATURE" \
  -d '{ "name": "Pro plan v2" }'

{
  "success": true,
  "data": {
    "id": "product_uuid",
    "name": "Pro plan v2"
  }
}

Product payment links

POST /api/v1/merchant/products/:id/links Creates a payment link attached to the product. Optional customerEmail, customerName, customerExternalId, and metadata.

curl -s -X POST "https://api.morapay.io/api/v1/merchant/products/product_uuid/links" \
  -H "Content-Type: application/json" \
  -H "Morapay-Key: $MORAPAY_PUBLIC_KEY" \
  -H "Morapay-Timestamp: $TIMESTAMP" \
  -H "Morapay-Signature: v1=$SIGNATURE" \
  -d '{
    "amount": 49,
    "currency": "USD",
    "customerEmail": "buyer@example.com"
  }'

201 Created

{
  "success": true,
  "data": {
    "id": "link_uuid",
    "productId": "product_uuid",
    "amount": 49,
    "currency": "USD",
    "publicCode": "abc123xyz"
  }
}

404 Not Found

{
  "success": false,
  "error": "Product not found.",
  "code": "resource.not_found",
  "requestId": "req_plink404"
}

GET /api/v1/merchant/products/:id/links lists links for the product.

Common errors

Code	HTTP	Cause
`resource.not_found`	404	Unknown product id
`request.invalid`	400	Invalid body
`kyb.forbidden`	403	LIVE mutation blocked by KYB
`auth.keys.invalid`	401	Invalid signed request

Getting started

Payments

Money movement

Account

Recurring and events

Public checkout

Catalog

Products

Endpoints

List products

Get product

Create product

Update product

Product payment links

Common errors

​Endpoints

​List products

​Get product

​Create product

​Update product

​Product payment links

​Common errors

​Related

Endpoints

List products

Get product

Create product

Update product

Product payment links

Common errors

Related