at.marque.partner.createCheckout
Schema Diff
+3 -3
Compatibility Analysis
Backward Compatible
No changes detected.
1
1
{
2
2
"id": "at.marque.partner.createCheckout",
3
3
"defs": {
4
4
"item": {
5
5
"type": "object",
6
6
"required": [
7
7
"domain"
8
8
],
9
9
"properties": {
10
10
"years": {
11
11
"type": "integer",
12
12
"maximum": 10,
13
13
"minimum": 1,
14
14
"description": "Registration period in years. Defaults to the TLD minimum."
15
15
},
16
16
"domain": {
17
17
"type": "string",
18
18
"maxLength": 253,
19
19
"description": "Fully qualified domain name to register."
20
20
},
21
21
"autoRenew": {
22
22
"type": "boolean",
23
23
"description": "Mark the domain to auto-renew before expiry using the user's saved payment method. Defaults to false. Auto-renewal is charged separately from this order."
24
24
},
25
25
"whoisPrivacy": {
26
26
"type": "boolean",
27
27
"description": "Whether to redact the registrant's details from public WHOIS. Defaults to true (privacy on) when omitted; set false to publish the registrant's contact data. Silently ignored for TLDs that do not allow it, and for TLDs whose registry redacts WHOIS regardless (see whoisPrivacyAllowed from listPricing / checkAvailability)."
28
28
}
29
29
}
30
30
},
31
31
"main": {
32
32
"type": "procedure",
33
33
"input": {
34
34
"schema": {
35
35
"type": "object",
36
36
"required": [
37
37
"items",
38
38
"registrant",
39
39
"successUrl",
40
40
"cancelUrl"
41
41
],
42
42
"properties": {
43
43
"items": {
44
44
"type": "array",
45
45
"items": {
46
46
"ref": "#item",
47
47
"type": "ref"
48
48
},
49
49
"maxLength": 50,
50
50
"minLength": 1,
51
51
"description": "Domains to register in this order, 1 to 50. Every domain must currently be available (verify with checkAvailability first); if any is unavailable or on an unsupported TLD the whole call fails."
52
52
},
53
53
"cancelUrl": {
54
54
"type": "string",
55
55
"format": "uri",
56
56
"description": "Where Stripe redirects if the user cancels."
57
57
},
58
58
"registrant": {
59
59
"ref": "#registrant",
60
60
"type": "ref"
61
61
},
62
62
"successUrl": {
63
63
"type": "string",
64
64
"format": "uri",
65
65
"description": "Where Stripe redirects after successful payment. An order parameter carrying the order id is appended."
66
66
}
67
67
}
68
68
},
69
69
"encoding": "application/json"
70
70
},
71
71
"errors": [
72
72
{
73
-
"name": "UnsupportedTld",
74
-
"description": "A requested TLD is not offered."
73
+
"name": "InvalidRequest",
74
+
"description": "The request is malformed: no items, too many items (max 50), or an item with an invalid domain."
75
75
},
76
76
{
77
77
"name": "Unavailable",
78
-
"description": "A requested domain is not available to register."
78
+
"description": "A requested domain cannot be registered: it is taken, on an unsupported TLD, or could not be verified with the registry. The message identifies the domain."
79
79
},
80
80
{
81
81
"name": "InvalidRegistrant",
82
82
"description": "The registrant is missing a required field (including state/province where the country requires it) or is missing an extra field a specific TLD mandates. The message names what is missing."
83
83
},
84
84
{
85
85
"name": "InvalidCallback",
86
86
"description": "successUrl or cancelUrl is not a valid absolute https URL."
87
87
}
88
88
],
89
89
"output": {
90
90
"schema": {
91
91
"type": "object",
92
92
"required": [
93
93
"orderId",
94
94
"checkoutUrl",
95
95
"subtotalCents",
96
96
"currency"
97
97
],
98
98
"properties": {
99
99
"orderId": {
100
100
"type": "string",
101
101
"description": "Opaque order id; pass to getOrder to poll status."
102
102
},
103
103
"currency": {
104
104
"type": "string",
105
105
"description": "ISO 4217 currency code of subtotalCents. Currently always usd."
106
106
},
107
107
"checkoutUrl": {
108
108
"type": "string",
109
109
"format": "uri",
110
110
"description": "Hosted Stripe Checkout URL to send the user to."
111
111
},
112
112
"subtotalCents": {
113
113
"type": "integer",
114
114
"description": "Order subtotal in cents, before tax. Tax (if any) is computed by Stripe on the hosted page and added on top, so the amount the user pays may be higher."
115
115
}
116
116
}
117
117
},
118
118
"encoding": "application/json"
119
119
},
120
120
"description": "Prices and validates the requested domains, ensures a registrant contact for the authenticated user, and returns a hosted Stripe Checkout URL. Call this proxied through the user's PDS (atproto-proxy: did:web:marque.at:api#marque_registrar) with a token holding the at.marque.partnerApi permission set: the authenticated user (the JWT iss) becomes the owner of the domains, and is the one billed on Stripe. The owning DID is taken from that authenticated session, never from input. The end user completes payment on Stripe's hosted page (where they see and confirm the exact domains and amount) and is redirected to successUrl with an order query parameter (successUrl?order=<orderId>) on success, or to cancelUrl if they abandon. Domains are not registered until payment is captured; poll at.marque.partner.getOrder with the returned orderId for provisioning status, then write the at.marque.domain and at.marque.dns records into the user's repository yourself. Only new registrations are supported here (no transfers or renewals)."
121
121
},
122
122
"registrant": {
123
123
"type": "object",
124
124
"required": [
125
125
"firstName",
126
126
"lastName",
127
127
"email",
128
128
"street",
129
129
"city",
130
130
"zipcode",
131
131
"country",
132
132
"phoneCountryCode",
133
133
"phoneSubscriber"
134
134
],
135
135
"properties": {
136
136
"city": {
137
137
"type": "string",
138
138
"maxLength": 255,
139
139
"description": "City or locality."
140
140
},
141
141
"email": {
142
142
"type": "string",
143
143
"maxLength": 320,
144
144
"description": "Registrant email. Must be a real, monitored address: registries may send a verification message here, and registry/transfer notifications go to it."
145
145
},
146
146
"state": {
147
147
"type": "string",
148
148
"maxLength": 255,
149
149
"description": "State, province, or region. Required for countries that mandate one (e.g. US, CA, AU, BR); send the full name or its ISO 3166-2 code (e.g. 'California' or 'CA'). Omit for countries that do not use one."
150
150
},
151
151
"street": {
152
152
"type": "string",
153
153
"maxLength": 255,
154
154
"description": "Street address including house/building number, e.g. '123 Main St'."
155
155
},
156
156
"country": {
157
157
"type": "string",
158
158
"maxLength": 2,
159
159
"minLength": 2,
160
160
"description": "ISO 3166-1 alpha-2 country code, uppercase, e.g. US, GB, DE. Determines which address/state rules apply."
161
161
},
162
162
"zipcode": {
163
163
"type": "string",
164
164
"maxLength": 32,
165
165
"description": "Postal/ZIP code. Required even where the country's format is loose."
166
166
},
167
167
"lastName": {
168
168
"type": "string",
169
169
"maxLength": 255,
170
170
"description": "Registrant's legal family name."
171
171
},
172
172
"firstName": {
173
173
"type": "string",
174
174
"maxLength": 255,
175
175
"description": "Registrant's legal given name."
176
176
},
177
177
"taxIdType": {
178
178
"type": "string",
179
179
"maxLength": 32,
180
180
"description": "Optional. Type of the tax identifier in taxIdValue, e.g. 'vat' for an EU VAT number or a registry-specific code. Send together with taxIdValue. Some TLDs (notably several EU ccTLDs registered to an organization) require a VAT number."
181
181
},
182
182
"taxIdValue": {
183
183
"type": "string",
184
184
"maxLength": 64,
185
185
"description": "Optional. The tax identifier itself, e.g. an EU VAT number like DE123456789. Paired with taxIdType."
186
186
},
187
187
"organization": {
188
188
"type": "string",
189
189
"maxLength": 255,
190
190
"description": "Optional. If set, the domain is registered to this organization rather than an individual. Leave empty for a personal registration."
191
191
},
192
192
"phoneAreaCode": {
193
193
"type": "string",
194
194
"maxLength": 16,
195
195
"description": "Optional area/city code, for regions that use one separately from the subscriber number."
196
196
},
197
197
"passportNumber": {
198
198
"type": "string",
199
199
"maxLength": 64,
200
200
"description": "Optional. Passport or national identity document number. Required by a few ccTLDs for individual registrants."
201
201
},
202
202
"phoneSubscriber": {
203
203
"type": "string",
204
204
"maxLength": 32,
205
205
"description": "Local subscriber number, digits only. Combined with phoneCountryCode (and phoneAreaCode) to form the full phone number. Required."
206
206
},
207
207
"phoneCountryCode": {
208
208
"type": "string",
209
209
"maxLength": 8,
210
210
"description": "International calling code with a leading plus, e.g. +1 for US/CA or +44 for UK. Required."
211
211
},
212
212
"socialSecurityNumber": {
213
213
"type": "string",
214
214
"maxLength": 64,
215
215
"description": "Optional. National identification / social security number, where a TLD mandates it (e.g. certain Nordic or Latin American ccTLDs). Handle as sensitive data."
216
216
},
217
217
"companyRegistrationNumber": {
218
218
"type": "string",
219
219
"maxLength": 64,
220
220
"description": "Optional. Company/commercial register number. Required by some TLDs when registering to an organization (organization set)."
221
221
}
222
222
},
223
223
"description": "The person or organization that will own the domains (the WHOIS registrant). Marque creates one registrant contact from these fields and uses it as the registrant, admin, tech, and billing contact for every domain in this order. Collect these in the partner's UI; the end user never visits Marque. All names and addresses must be real and accurate. Most gTLDs require the registrant email to be verifiable, so a registry verification email may be sent to it after registration; an unverified address can cause some TLDs to suspend the domain until confirmed. Certain TLDs require extra fields beyond these (for example a tax/VAT or national ID); those orders fail with InvalidRegistrant naming the missing field, and are not yet supported through this endpoint."
224
224
}
225
225
},
226
226
"$type": "com.atproto.lexicon.schema",
227
227
"lexicon": 1,
228
228
"description": "Create a hosted Stripe Checkout session to register one or more domains for the calling user."
229
229
}