For Partners

Create orders. Send invoices. Get paid.

Our Partner API lets you generate invoices for personalized apparel and leather on behalf of your customers. POST an order, get back a hosted pay link on monogram.shop — your customer pays through our secure checkout, and we handle production and shipping end-to-end. You set the amount, you set the customization — the invoice mirrors what you're billing.

1 · Authenticate

Send your API key in the Authorization header.

2 · POST an order

Pass items, customer details, your reference, and (optionally) your own amount.

3 · Share the link

We return a hosted payment page on our site.

Payment widget

Take payments on your own site in two lines

Onboard once, then drop our widget onto any page your clients use. Your customer pays on a secure hosted page, you receive a signed webhook the moment it clears, and they're sent back to your success URL. No PCI scope, no card data ever touching your servers.

1 · Get keys

2 · Add a product

Map a product id to a price and currency.

3 · Embed the script

Paste the snippet; any [data-xpay] button opens checkout.

4 · Receive events

We POST signed payment.* events to your webhook URL.

1 · Embed (no-code button)

Add the script once. Every [data-xpay] element on the page opens the payment modal.

<script src="https://your-domain.com/widget.js"
  data-publishable-key="pk_live_xxx"
  data-product="starter-pack"></script>

<button data-xpay>Pay now</button>

Override per button with data-product, data-success-url, data-cancel-url.

2 · Or open it from code

Already know the buyer's email? Pass it and skip the form. Hook onSuccess to update your UI.

XPay.open({
  product: "starter-pack",
  email: "customer@example.com",   // optional
  country: "LK",                    // optional
  successUrl: "/thank-you",         // optional
  onSuccess(txn) {
    console.log("paid", txn.transactionId);
  }
});

3 · Server-to-server (no widget) · POST /api/widget/checkout

Create the payment from your backend and redirect the customer to the returned paymentUrl. The amount is priced from your catalogue, so it can't be tampered with client-side.

curl -X POST https://your-domain.com/api/widget/checkout \
  -H 'Content-Type: application/json' \
  -d '{
    "publishableKey": "pk_live_xxx",
    "product": "starter-pack",
    "email": "customer@example.com",
    "phone": "0771234567",
    "country": "LK",
    "state": "Western"
  }'

# → { "transactionId": "Ab3...", "paymentUrl": "https://pay…",
#     "amount": "3.00", "currency": "USD", "status": "pending" }

Poll GET /api/widget/status/<transactionId> for settlement, or rely on your webhook. Both are CORS-enabled.

Webhook events

Set your webhook + redirect URLs in Settings. We POST payment.paid / payment.failed / payment.cancelled, signed with HMAC-SHA256 in the x-signature header (verify against your webhook secret).

POST https://your-domain.com/your-webhook
x-signature: sha256=<hmac>
Content-Type: application/json

{
  "id": "evt_…",
  "type": "payment.paid",
  "created_at": "2026-06-12T10:21:44.000Z",
  "data": {
    "transaction_id": "Ab3xYz9Qm2",
    "product_id": "starter-pack",
    "status": "paid",
    "amount": "3.00",
    "currency": "USD",
    "customer": { "email": "customer@example.com", "country": "LK" }
  }
}

Try it live

Publishable key

Product id

User uuid (optional — blank uses the shared default user)

Create a key + product in the admin portal, paste them above, and watch the exact flow your partners' customers see.

Open admin portal Full-page demo

Endpoints

All four endpoints at a glance

Every endpoint takes the same Bearer authentication. Anchor links jump to the section with full request/response details.

Method	Path	What it does	Details
POST	/api/v1/partner/orders	Create an invoice. Returns a hosted pay link.	jump ↓
GET	/api/v1/partner/orders	List your invoices. Filter by status or reference, paginate with cursor.	jump ↓
GET	/api/v1/partner/orders/{id}	Fetch one invoice in full — items, personalization, breakdown.	jump ↓
GET	/api/products	Live product catalog. Same data as the section below.	jump ↓
POST	your webhook URL	We POST payment events to you — success, decline, pending.	jump ↓

Common gotcha: the path is /orders (plural), not /order.

Anatomy of a request

What the fields mean

Every order body has the same five concepts. Get these right and the rest follows — examples below.

productSlug

A short, URL-safe identifier for a product family. Lowercase, hyphenated, stable forever.

monogram-tee

Pick from the catalog below.

variantSku

The specific size/colour/material option within a product. Globally unique.

tee-blk-m

Must belong to the productSlug you've chosen.

personalization

Customization keys vary per product (monogram, thread, placement…).

{ "monogram": "J.D.", "thread": "Gold" }

Required fields are marked on each product card.

amountCents

Optional. Your own unit price in integer cents — overrides catalog price.

7500  // $75.00

Up to $100,000 per line item. Omit to use the catalog price.

reference

Optional. Your invoice ID. We store and echo it back on the order and webhooks.

INV-2026-00891

Max 120 chars. Useful for reconciliation.

quantity

How many of this variant. Integer between 1 and 50 per line item.

Subtotal = (amountCents or catalog price) × quantity.

Partner-set pricing

Add an amountCents field to any line item to bill at the price you've quoted, instead of the catalog price. The hosted pay link will charge that exact total — ideal for wholesale, bespoke runs, gift orders, or contracted rates.

· amountCents is the unit price in cents — subtotal = amountCents × quantity.
· Up to $100,000 per line item. Omit to fall back to the catalog price shown below.
· Personalization length limits are relaxed on partner orders — submit the monogram, message or engraving as quoted.
· Required personalization fields are still enforced — partners must send all keys marked required.

Catalog

Every product, every variant

Use the productSlug and variantSku values below in your order body. Personalization keys differ per product — each card lists exactly what to send.

Tees · 4 Hoodies · 3 Caps & hats · 5 Jackets · 4 Leather · 11 Accessories · 12

Tees

4 products

Pocket Tee

$38

productSlug: pocket-tee

Heavyweight cotton with an embroidered pocket.

Variants

variantSku	Option	Price
pk-tee-blk-s	Black · S	$38
pk-tee-blk-m	Black · M	$38
pk-tee-blk-l	Black · L	$38
pk-tee-ecr-m	Ecru · M	$38
pk-tee-ecr-l	Ecru · L	$38

Personalization keys

initialstextrequiredmax 3 chars (web only — relaxed for partners)
threadselectrequired
IvoryBlackTanGold

Cotton Henley

$42

productSlug: henley

Long-sleeve henley with embroidered placket.

Variants

variantSku	Option	Price
hn-ecr-m	Ecru · M	$42
hn-ecr-l	Ecru · L	$42
hn-cha-m	Charcoal · M	$42
hn-cha-l	Charcoal · L	$42

Personalization keys

monogramtextrequiredmax 3 chars (web only — relaxed for partners)
threadselectrequired
IvoryBlackTan

Long-Sleeve Tee

$45

productSlug: long-sleeve-tee

Garment-washed cotton, embroidered sleeve.

Variants

variantSku	Option	Price
ls-blk-m	Black · M	$45
ls-blk-l	Black · L	$45
ls-ecr-m	Ecru · M	$45
ls-ecr-l	Ecru · L	$45

Personalization keys

monogramtextrequiredmax 3 chars (web only — relaxed for partners)

Monogram Tee

$35

productSlug: monogram-tee

Heavyweight cotton, embroidered with your initials.

Variants

variantSku	Option	Price
tee-blk-s	Black · S	$35
tee-blk-m	Black · M	$35
tee-blk-l	Black · L	$35
tee-ecr-m	Ecru · M	$35
tee-ecr-l	Ecru · L	$35

Personalization keys

monogramtextrequiredmax 3 chars (web only — relaxed for partners)
threadselectrequired
IvoryBlackTanGold

Hoodies

3 products

Zip-Up Hoodie

$82

productSlug: zip-hoodie

Heavyweight French terry with custom embroidery.

Variants

variantSku	Option	Price
zh-cha-s	Charcoal · S	$82
zh-cha-m	Charcoal · M	$82
zh-cha-l	Charcoal · L	$82
zh-cha-xl	Charcoal · XL	$82
zh-olv-m	Olive · M	$82
zh-olv-l	Olive · L	$82

Personalization keys

texttextrequiredmax 18 chars (web only — relaxed for partners)
placementselectrequired
Left chestRight sleeve

Cropped Hoodie

$68

productSlug: cropped-hoodie

Boxy crop, midweight terry, embroidered.

Variants

variantSku	Option	Price
ch-ecr-s	Ecru · S	$68
ch-ecr-m	Ecru · M	$68
ch-blk-s	Black · S	$68
ch-blk-m	Black · M	$68

Personalization keys

texttextrequiredmax 12 chars (web only — relaxed for partners)

Atelier Hoodie

$72

productSlug: atelier-hoodie

Heavyweight French terry, custom embroidery.

Variants

variantSku	Option	Price
hd-cha-s	Charcoal · S	$72
hd-cha-m	Charcoal · M	$72
hd-cha-l	Charcoal · L	$72
hd-cha-xl	Charcoal · XL	$72

Personalization keys

texttextrequiredmax 18 chars (web only — relaxed for partners)
placementselectrequired
Left chestRight sleeveBack nape

Caps & hats

5 products

Trucker Cap

$28

productSlug: trucker-cap

5-panel mesh-back, embroidered crest.

Variants

variantSku	Option	Price
trk-blk	Black/White mesh	$28
trk-nvy	Navy/White mesh	$28
trk-olv	Olive/Tan mesh	$28

Personalization keys

texttextrequiredmax 10 chars (web only — relaxed for partners)

Bucket Hat

$34

productSlug: bucket-hat

Washed canvas, embroidered side tab.

Variants

variantSku	Option	Price
bkt-stn	Stone	$34
bkt-olv	Olive	$34
bkt-blk	Black	$34

Personalization keys

initialstextrequiredmax 3 chars (web only — relaxed for partners)

Washed Dad Cap

$30

productSlug: washed-dad-cap

Soft-crown twill, unstructured, embroidered.

Variants

variantSku	Option	Price
dad-blk	Washed Black	$30
dad-stn	Washed Stone	$30
dad-olv	Washed Olive	$30
dad-nvy	Washed Navy	$30

Personalization keys

texttextrequiredmax 10 chars (web only — relaxed for partners)

Cable Beanie

$26

productSlug: cable-beanie

Chunky cable knit, embroidered cuff.

Variants

variantSku	Option	Price
bn-cha	Charcoal	$26
bn-ecr	Ecru	$26
bn-rst	Rust	$26

Personalization keys

initialstextrequiredmax 3 chars (web only — relaxed for partners)
threadselectrequired
IvoryBlackTanGold

Field Cap

$32

productSlug: field-cap

6-panel washed canvas with embroidered detail.

Variants

variantSku	Option	Price
cap-stn	Stone	$32
cap-olv	Olive	$32
cap-blk	Black	$32

Personalization keys

emblemtextrequiredmax 8 chars (web only — relaxed for partners)

Jackets

4 products

Chore Coat

$138

productSlug: chore-coat

Cotton drill, four pockets, embroidered.

Variants

variantSku	Option	Price
cc-ind-m	Indigo · M	$138
cc-ind-l	Indigo · L	$138
cc-blk-m	Black · M	$138
cc-blk-l	Black · L	$138
cc-stn-m	Stone · M	$138

Personalization keys

nametextrequiredmax 14 chars (web only — relaxed for partners)

Bomber Jacket

$165

productSlug: bomber-jacket

Cotton/nylon shell, embroidered chest.

Variants

variantSku	Option	Price
bm-blk-s	Black · S	$165
bm-blk-m	Black · M	$165
bm-blk-l	Black · L	$165
bm-olv-m	Olive · M	$165
bm-olv-l	Olive · L	$165

Personalization keys

texttextrequiredmax 16 chars (web only — relaxed for partners)

Varsity Jacket

$185

productSlug: varsity-jacket

Melton wool body, leather sleeves, chenille letter.

Variants

variantSku	Option	Price
vs-blk-m	Black wool · Black leather · M	$185
vs-blk-l	Black wool · Black leather · L	$185
vs-nvy-m	Navy wool · Cream leather · M	$185
vs-nvy-l	Navy wool · Cream leather · L	$185

Personalization keys

lettertextrequiredmax 1 chars (web only — relaxed for partners)

Selvedge Denim Jacket

$145

productSlug: selvedge-denim-jacket

13.5oz Japanese selvedge, embroidered to order.

Variants

variantSku	Option	Price
dj-ind-s	Indigo · S	$145
dj-ind-m	Indigo · M	$145
dj-ind-l	Indigo · L	$145

Personalization keys

designtextrequiredmax 24 chars (web only — relaxed for partners)
placementselectrequired
ChestBack yoke

Leather

11 products

Card Holder

from $48

productSlug: card-holder

Italian full-grain leather, four slots.

Variants

variantSku	Option	Price
ch-tan	Tan	$48
ch-brn	Walnut	$48
ch-blk	Black	$52

Personalization keys

initialstextrequiredmax 3 chars (web only — relaxed for partners)

AirPods Case

$42

productSlug: airpods-case

Snap-on leather sleeve, debossed initials.

Variants

variantSku	Option	Price
ap-pro-tan	Pro · Tan	$42
ap-pro-blk	Pro · Black	$42
ap-std-tan	Standard · Tan	$42
ap-std-blk	Standard · Black	$42

Personalization keys

initialstextrequiredmax 3 chars (web only — relaxed for partners)

Leather Watch Strap

$58

productSlug: watch-strap

Hand-stitched bridle leather, custom sized.

Variants

variantSku	Option	Price
ws-tan	Tan · 20mm	$58
ws-brn	Walnut · 20mm	$58
ws-blk	Black · 20mm	$58
ws-ox	Oxblood · 20mm	$58

Personalization keys

stamptextrequiredmax 12 chars (web only — relaxed for partners)

Passport Holder

from $78

productSlug: passport-holder

Full-grain leather, debossed crest.

Variants

variantSku	Option	Price
ph-tan	Tan	$78
ph-brn	Walnut	$78
ph-blk	Black	$84

Personalization keys

initialstextrequiredmax 3 chars (web only — relaxed for partners)

Money Clip

$36

productSlug: money-clip

Leather-wrapped spring steel, engraved.

Variants

variantSku	Option	Price
mc-tan	Tan	$36
mc-brn	Walnut	$36
mc-blk	Black	$36

Personalization keys

engravingtextrequiredmax 12 chars (web only — relaxed for partners)

Refillable Leather Notebook

$95

productSlug: leather-notebook

A6 refillable cover, blind-debossed.

Variants

variantSku	Option	Price
nb-tan	Tan	$95
nb-brn	Walnut	$95
nb-blk	Black	$95

Personalization keys

nametextrequiredmax 18 chars (web only — relaxed for partners)

Leather Coasters (Set of 4)

$32

productSlug: leather-coasters

Vegetable-tanned, engraved initials.

Variants

variantSku	Option	Price
lc-nat	Natural	$32
lc-brn	Walnut	$32
lc-blk	Black	$32

Personalization keys

initialstextrequiredmax 3 chars (web only — relaxed for partners)

Leather Desk Mat

$125

productSlug: leather-desk-mat

Full-grain workspace mat, hot-stamped corner.

Variants

variantSku	Option	Price
dm-tan	Tan	$125
dm-brn	Walnut	$125
dm-blk	Black	$125

Personalization keys

stamptextrequiredmax 18 chars (web only — relaxed for partners)

Engraved Bifold Wallet

from $88

productSlug: engraved-wallet

Italian full-grain leather, engraved interior.

Variants

variantSku	Option	Price
wlt-tan	Tan	$88
wlt-brn	Walnut	$88
wlt-blk	Black	$94

Personalization keys

nametextrequiredmax 24 chars (web only — relaxed for partners)
datedateoptional

Engraved Belt

$95

productSlug: engraved-belt

Solid brass buckle, full-grain leather strap.

Variants

variantSku	Option	Price
bl-32	32"	$95
bl-34	34"	$95
bl-36	36"	$95
bl-38	38"	$95

Personalization keys

stamptextrequiredmax 20 chars (web only — relaxed for partners)

Weekend Duffle

$385

productSlug: weekend-duffle

Pebbled leather, monogrammed luggage tag.

Variants

variantSku	Option	Price
duf-cog	Cognac	$385
duf-blk	Black	$385

Personalization keys

tagtextrequiredmax 3 chars (web only — relaxed for partners)

Accessories

12 products

Iron-on Patch

from $6

productSlug: iron-on-patch

Woven twill, merrowed edge, custom text.

Variants

variantSku	Option	Price
ptc-blk	Black/Ivory	$6
ptc-olv	Olive/Tan	$6
ptc-nvy	Navy/Gold	$7

Personalization keys

texttextrequiredmax 12 chars (web only — relaxed for partners)

Engraved Key Fob

$24

productSlug: key-fob

A small piece of leather you actually use every day.

Variants

variantSku	Option	Price
kf-nat	Natural	$24
kf-brn	Brown	$24

Personalization keys

texttextrequiredmax 14 chars (web only — relaxed for partners)

Monogram Sticker Pack

from $3

productSlug: monogram-sticker-pack

A starter set of die-cut vinyl stickers.

Variants

variantSku	Option	Price
stk-wht	White ink	$3
stk-blk	Black ink	$3
stk-gld	Gold foil	$4.50

Personalization keys

initialstextrequiredmax 3 chars (web only — relaxed for partners)

Enamel Pin

from $5

productSlug: enamel-pin

Hard enamel, custom initials, butterfly clutch.

Variants

variantSku	Option	Price
pin-brs	Brass	$5
pin-slv	Silver	$6
pin-gld	Gold-plated	$8

Personalization keys

initialstextrequiredmax 3 chars (web only — relaxed for partners)

Leather Bookmark

from $8

productSlug: leather-bookmark

Vegetable-tanned strip, hot-stamped initials.

Variants

variantSku	Option	Price
bkm-nat	Natural	$8
bkm-brn	Brown	$8
bkm-blk	Black	$9

Personalization keys

stamptextrequiredmax 4 chars (web only — relaxed for partners)

Woven Lanyard

productSlug: woven-lanyard

Jacquard-woven cotton with your name.

Variants

variantSku	Option	Price
lyd-blk	Black/Ivory	$9
lyd-nvy	Navy/Cream	$9
lyd-olv	Olive/Tan	$9

Personalization keys

texttextrequiredmax 16 chars (web only — relaxed for partners)

Phone Strap

$12

productSlug: phone-strap

Braided cord, leather tab, embossed initials.

Variants

variantSku	Option	Price
phs-blk	Black cord · Black tab	$12
phs-tan	Sand cord · Tan tab	$12
phs-olv	Olive cord · Walnut tab	$12

Personalization keys

initialstextrequiredmax 3 chars (web only — relaxed for partners)

Cotton Bandana

$14

productSlug: cotton-bandana

Hand-printed cotton, embroidered corner.

Variants

variantSku	Option	Price
bnd-ind	Indigo	$14
bnd-rst	Rust	$14
bnd-blk	Black	$14

Personalization keys

initialstextrequiredmax 3 chars (web only — relaxed for partners)

Monogram Socks

$16

productSlug: monogram-socks

Combed cotton crew, embroidered cuff.

Variants

variantSku	Option	Price
sck-blk	Black	$16
sck-ecr	Ecru	$16
sck-olv	Olive	$16
sck-nvy	Navy	$16

Personalization keys

monogramtextrequiredmax 3 chars (web only — relaxed for partners)

Canvas Tote

$18

productSlug: canvas-tote

14oz heavy canvas, custom screen print.

Variants

variantSku	Option	Price
tot-nat	Natural · Black ink	$18
tot-blk	Black · White ink	$18
tot-olv	Olive · Ivory ink	$18

Personalization keys

texttextrequiredmax 18 chars (web only — relaxed for partners)

Knit Gloves

$24

productSlug: knit-gloves

Lambswool, embroidered cuff.

Variants

variantSku	Option	Price
glv-cha	Charcoal	$24
glv-cml	Camel	$24
glv-blk	Black	$24

Personalization keys

monogramtextrequiredmax 3 chars (web only — relaxed for partners)

Wool Scarf

$32

productSlug: wool-scarf

Lambswool, fringed edge, embroidered initials.

Variants

variantSku	Option	Price
scf-cha	Charcoal	$32
scf-cml	Camel	$32
scf-nvy	Navy	$32

Personalization keys

initialstextrequiredmax 3 chars (web only — relaxed for partners)

POST /api/v1/partner/orders — Example request

POST /api/v1/partner/orders HTTP/1.1
Host: monogram.shop
Authorization: Bearer YOUR_PARTNER_KEY
Content-Type: application/json

{
  "reference": "INV-2026-00891",
  "customer": {
    "name": "Jane Doe",
    "email": "jane@example.com",
    "address": {
      "line1": "12 Hudson Yards",
      "city": "New York",
      "region": "NY",
      "postalCode": "10001",
      "country": "US"
    }
  },
  "items": [
    {
      "productSlug": "monogram-tee",
      "variantSku": "tee-blk-m",
      "quantity": 2,
      "amountCents": 7500,
      "personalization": { "monogram": "J.D.", "date": "2026-05-24", "thread": "Gold" }
    }
  ],
  "notes": "Gift wrap"
}

Example response

HTTP/1.1 201 Created
Content-Type: application/json

{
  "id": "K4n7XQpA",
  "status": "pending",
  "reference": "INV-2026-00891",
  "subtotalCents": 15000,
  "shippingCents": 0,
  "taxCents": 0,
  "totalCents": 15000,
  "currency": "USD",
  "payUrl": "https://monogram.shop/pay/K4n7XQpA",
  "createdAt": "2026-05-24T13:11:02.341Z"
}

Reading back

Fetching invoices

You can list every invoice you've created, or fetch one by id. Authentication is the same Bearer key you used to create the order — we'll only return invoices created with your key.

GET/api/v1/partner/orders

List your invoices, newest first. Returns a summary row per invoice plus a nextCursor for pagination.

Query parameters

status · pending | paid | fulfilled | cancelled
reference · your invoice ID, exact match
cursor · ISO timestamp from previous response
limit · 1–100, default 25

Example

GET /api/v1/partner/orders?status=paid&limit=10
Authorization: Bearer YOUR_PARTNER_KEY

Response

{
  "orders": [
    {
      "id": "K4n7XQpA",
      "status": "paid",
      "reference": "INV-2026-00891",
      "customer": { "name": "Jane Doe", "email": "jane@example.com" },
      "subtotalCents": 15000,
      "shippingCents": 0,
      "taxCents": 0,
      "totalCents": 15000,
      "currency": "USD",
      "payUrl": "https://monogram.shop/pay/K4n7XQpA",
      "itemCount": 2,
      "createdAt": "2026-05-24T13:11:02.341Z",
      "paidAt": "2026-05-24T13:18:44.001Z"
    }
  ],
  "nextCursor": "2026-05-24T13:11:02.341Z"
}

GET/api/v1/partner/orders/{id}

Full invoice payload — items, personalization, customer, pricing breakdown, and dates. Returns 404 if the invoice wasn't created with your API key.

Example

GET /api/v1/partner/orders/K4n7XQpA
Authorization: Bearer YOUR_PARTNER_KEY

Response

{
  "id": "K4n7XQpA",
  "status": "paid",
  "reference": "INV-2026-00891",
  "customer": {
    "name": "Jane Doe",
    "email": "jane@example.com",
    "address": { "line1": "12 Hudson Yards", "city": "New York", ... }
  },
  "items": [
    {
      "productSlug": "monogram-tee",
      "productName": "Monogram Tee",
      "variantSku": "tee-blk-m",
      "variantLabel": "Black · M",
      "quantity": 2,
      "unitPriceCents": 7500,
      "lineTotalCents": 15000,
      "personalization": { "monogram": "J.D.", "thread": "Gold" }
    }
  ],
  "subtotalCents": 15000,
  "shippingCents": 0,
  "taxCents": 0,
  "totalCents": 15000,
  "currency": "USD",
  "payUrl": "https://monogram.shop/pay/K4n7XQpA",
  "notes": "Gift wrap",
  "createdAt": "2026-05-24T13:11:02.341Z",
  "paidAt": "2026-05-24T13:18:44.001Z",
  "updatedAt": "2026-05-24T13:18:44.001Z"
}

Pagination tip

On every list response, if nextCursor is non-null, pass it back as ?cursor=<value> to get the next page. When nextCursor comes back as null, you've reached the end.

Webhooks

Payment events, pushed to you

Give us a public HTTPS URL and we'll POST a JSON payload every time a payment moves — success, failed, pending, created. One envelope (event: "payment.notify"), all the detail inside data: status, message, amount, customer info, masked card, and both transaction ids so reconciliation is a single field match.

data.status values

success — charge cleared, order marked paid on our side.
failed — decline or processor error. message carries the reason.
pending — awaiting confirmation (e.g. async payment methods).
created — customer initiated checkout; not yet captured.

Delivery

· POST with Content-Type: application/json.
· Respond 2xx within a few seconds. Non-2xx is retried on the next upstream redelivery.
· The same payment may notify more than once — dedupe on data.transaction_id + data.status.
· Timestamps are UTC, format YYYY-MM-DD HH:MM:SS.

data fields

transaction_id · our payment transaction id
merchant_transaction_id · order publicId — matches the id returned at create time
status · success · failed · pending · created
amount · string with 2 decimals, e.g. "50.00"
currency · uppercase ISO, e.g. "USD"
message · human-readable; on failed this carries the processor's decline reason
customer_info · name, email, phone, line1, city, state, postal_code, country
created_at / processed_at · UTC YYYY-MM-DD HH:MM:SS

Example: success

POST https://your-domain.com/webhook
Content-Type: application/json

{
  "event": "payment.notify",
  "data": {
    "transaction_id": "pay_Cf7Gr7PgqIObMAcM",
    "merchant_transaction_id": "K4n7XQpA",
    "status": "success",
    "amount": "150.00",
    "currency": "USD",
    "message": "Payment completed.",
    "customer_info": {
      "phone": "+19876543210",
      "line1": "12 Hudson Yards",
      "postal_code": "10001",
      "city": "New York",
      "state": "NY",
      "name": "Jane Doe",
      "email": "jane@example.com",
      "country": "US"
    },
    "created_at": "2026-05-24 13:11:02",
    "processed_at": "2026-05-24 13:18:44"
  }
}

Example: failed

POST https://your-domain.com/webhook
Content-Type: application/json

{
  "event": "payment.notify",
  "data": {
    "transaction_id": "pay_Cf7Gr7PgqIObMAcN",
    "merchant_transaction_id": "K4n7XQpA",
    "status": "failed",
    "amount": "150.00",
    "currency": "USD",
    "message": "Your card was declined.",
    "customer_info": {
      "phone": "+19876543210",
      "line1": "12 Hudson Yards",
      "postal_code": "10001",
      "city": "New York",
      "state": "NY",
      "name": "Jane Doe",
      "email": "jane@example.com",
      "country": "US"
    },
    "created_at": "2026-05-24 13:11:02",
    "processed_at": "2026-05-24 13:19:02"
  }
}

Setting your URL

Email partners@monogram.online with the HTTPS endpoint you want events delivered to. We'll wire it up against your API key — sandbox and live can point to different URLs if you want to keep test traffic separate.

If something fails

Common errors

Message	Cause	Fix
Unauthorized	Missing or invalid Bearer token.	Re-check the Authorization header.
Validation failed (422)	Body doesn't match our schema. Response includes an issues map.	Match field names and types to the anatomy block above.
Unknown product: <slug>	productSlug isn't in the catalog or has been deactivated.	Use a slug shown in the catalog below.
Unknown variant <sku> for product <slug>	The SKU doesn't belong to that product.	Check the variant rows of the product card.
Missing required personalization "<key>"	A required customization key is absent or empty.	Send every key marked required on the product card.

Personalization maxLength errors never apply to partner orders — those limits are relaxed for you.

Full API reference Request an API key