get_domain_register_pay_link
Get a real, payable Machine Payment Protocol (MPP) URL to register a FRESH domain (an available domain that is NOT a curated Atom marketplace listing — for that, use get_domain_purchase_pay_link instead) via Stripe SPT — for use with an MPP-native payment agent (e.g. Stripe's link-cli), NOT with register_domain_spt's own payment flow (that tool's challenge cannot be paid by an external MPP agent). Use this ONLY when an MPP-native agent's tools (e.g. link-cli's mpp_pay) are available in this session.
PAYMENT PRIORITY: this is priority 2 for a fresh registration — reach for it only after register_domain_spt's own in-band payment flow (priority 1) isn't viable (no payment_token available from your own platform), and only when link-cli is present. Always hand over the exact server-computed pay_url/price returned here — never estimate or recompute the amount yourself. There is no checkout-link fallback for a fresh registration.
Returns a pay_url that a real HTTP 402 challenge is served from — hand it directly to the MPP agent's pay tool (e.g. mpp_pay) rather than fetching or decoding it yourself. term_years is never a caller input — always derived server-side from the TLD.
If this reports error 'registrant_contact_required' (a registry needs this to complete registration), ask the user for their name, phone, address, city, zip, and country, call create_registrant_contact with those, then retry this tool — this is expected and not a dead end.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| domain | Yes | The domain to register, including extension. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | ||
| price | No | ||
| domain | Yes | ||
| pay_url | Yes | Real MPP-payable URL — hand this to an MPP agent, do not fetch it yourself. | |
| success | Yes | ||
| currency | No | ||
| expires_at | No | ||
| term_years | No |