zdfi.me. It’s the same link either way.
Money settles to your own Zend account. There’s no separate merchant account.
Get an API key
zdev_live_...) to ~/.zend/config.json. To make a narrower key for your server, run zend keys create.
Create a payment request
Send
payment.linkUrl to your customer, or put it behind a Pay with Zend button.
Needs the create_payment_request scope.
Confirm the payment
Credit the order on the webhook, not on the redirect.zend config set webhookUrl <url>. Zend creates your webhook secret (whsec_...) the first time you set a URL. Signatures use the same t=<unix>,v1=<hex> scheme as ZApp webhooks, and are rejected after 5 minutes.
Events fire only for requests you created through the API or CLI, never for ordinary payments between people. Failed deliveries retry after 1 minute, 5 minutes, 15 minutes, 1 hour and 1 day. See recent deliveries with
zend logs tail.
Return to your site
WithredirectUrl set, the payer comes back to your site with ?zend_return_token=.... Check it before resuming their session:
valid: false, with no reason given.
Check without charging
zend payments test, or zend.testPaymentRequest(input), runs the same checks as a real request without creating it, moving money, or sending a webhook. Use it in CI.
Look up requests
status is pending, paid, expired or cancelled.
Full SDK reference
TypeScript
pay-with-zend-sdk on npmPython
pay-with-zend-sdk on PyPIGo
github.com/zendfi/zend-go-sdk