Integration guide

Create a payment link that opens ZEC-Pay with the payment details already completed. Add this link to your checkout, invoice, or donation page. When the customer clicks it, they are sent to ZEC-Pay to review the payment and complete the order.

No API Work

No authentication, signing, SDK or webhook setup. Just generate a link and redirect the buyer

Shielded Delivery

Your shop can request payment to a shielded Zcash address together with a memo

More Customer Wallets

The customer may still pay even if they only hold Bitcoin or transparent ZEC

Pre-Filled Orders

Set amount, destination and memo in advance so checkout stays simple and mistakes are reduced

Integration link format

https://zec-pay.com/pay/#amount=...;to=...;memo=...;end

Parameter Required Description Example
amount Yes Amount of ZEC the recipient should receive. Use a dot as the decimal separator 0.125
to Yes The recipient shielded Zcash address that should receive the final payment u1... or z...
memo Yes The memo attached to the final shielded Zcash transaction. URL-encode special characters and spaces Order%20%231024
end Yes Terminator marking the end of the fragment payload ;end

Recommended Merchant Flow

  • Create the order in your own system first
  • Generate a unique memo containing the order reference
  • Build the ZEC-Pay link with amount, shielded recipient and memo
  • Send the customer to that link from checkout or invoice email
  • Match the completed payment using the memo and your own internal records
Important: This page documents a customer redirect flow. It does not expose an authenticated API endpoint for backend payment creation.

Sample Link

https://zec-pay.com/pay/#amount=0.015;to=zs1exampleAddress;memo=ORDER-100245;end

What Your Shop Needs To Store

In most cases, your system should keep the order ID, expected amount, destination address used for the request, memo value and your own payment status. The ZEC-Pay link itself can always be rebuilt from those values when needed.

<a href="https://zec-pay.com/pay/#amount=0.015;to=zs1exampleShieldedAddressReplaceThisWithYourOwnRecipientAddress;memo=ORDER-100245;end">Pay with ZEC-Pay</a>
1. Determine order amount in ZEC 2. Create unique order memo 3. Insert values into the ZEC-Pay link 4. Redirect customer to the generated URL
Use a memo value that your staff or your software can recognize immediately. This makes reconciliation simpler than relying on free-form customer input.

Implementation Notes

These points usually matter most when adding ZEC-Pay to a live shop or invoicing flow.

Fragment Format

The values come after #, not in the query string. Keep the final ;end marker in place

Encode Values

Amounts should be plain decimal strings. Memo text should be URL-encoded before insertion into the link

Memo Strategy

Use a stable reference such as order number, invoice ID, subscription code or internal payment token

Checkout Use

This works well for buy buttons, one-off invoices, donation links, subscription renewals and manual payment pages