Get checkout session by ID
Returns details for a single checkout session. Requires a secret-key (sk_*) authenticated caller with the payment-experience:checkout:view permission. Does NOT return the clientSecret — that field is only returned in the create response. Soft-deleted sessions are not returned.
Authorization
bearer In: header
Path Parameters
Response Body
application/json
curl -X GET "https://api.miracle.com/v1/checkout-sessions/string"{
"data": {
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"tenantId": "f97df110-f4de-492e-8849-4a6af68026b0",
"merchantId": "c3073b9d-edd0-49f2-a28d-b7ded8ff9a8b",
"merchantName": "string",
"tenantName": "string",
"termsUrl": "string",
"privacyUrl": "string",
"livemode": true,
"status": "open",
"paymentStatus": "processing",
"amount": {
"currency": "string",
"valueMinor": 0
},
"lineItems": [
{
"id": "string",
"productId": "string",
"label": "string",
"description": "string",
"imageUrl": "string",
"unitAmount": {
"currency": "string",
"valueMinor": 0
},
"quantity": 1,
"taxRate": 0,
"taxAmount": {
"currency": "string",
"valueMinor": 0
},
"metadata": {
"property1": "string",
"property2": "string"
}
}
],
"totals": [
{
"type": "total",
"displayText": "string",
"amount": {
"currency": "string",
"valueMinor": 0
},
"description": "string"
}
],
"fulfillmentOptions": [
{
"id": "string",
"type": "shipping",
"title": "string",
"description": "string",
"price": {
"currency": "string",
"valueMinor": 0
},
"estimatedDelivery": {
"earliest": "string",
"latest": "string"
}
}
],
"selectedFulfillment": {
"fulfillmentOptionId": "string",
"type": "shipping",
"title": "string",
"price": {
"currency": "string",
"valueMinor": 0
}
},
"url": "string",
"clientSecret": "string",
"merchantReference": "string",
"paymentId": "472e651e-5a1e-424d-8098-23858bf03ad7",
"providerCheckoutId": "string",
"customerInfo": {
"email": "string",
"phone": "string",
"name": "string",
"firstName": "string",
"lastName": "string",
"companyName": "string",
"dateOfBirth": "string",
"taxId": "string",
"taxIds": [
{
"type": "string",
"country": "string",
"value": "string"
}
],
"nationalId": "string",
"locale": "string",
"language": "string",
"customerReference": "string",
"ipAddress": "string",
"billingAddress": {
"streetName": "string",
"buildingNumber": "string",
"buildingName": "string",
"unit": "string",
"floor": "string",
"addressLine1": "string",
"addressLine2": "string",
"city": "string",
"region": "string",
"postalCode": "string",
"country": "string",
"department": "string"
},
"shippingAddress": {
"streetName": "string",
"buildingNumber": "string",
"buildingName": "string",
"unit": "string",
"floor": "string",
"addressLine1": "string",
"addressLine2": "string",
"city": "string",
"region": "string",
"postalCode": "string",
"country": "string",
"dependentLocality": "string",
"sortingCode": "string",
"organization": "string",
"recipient": "string",
"phone": "string",
"email": "string"
},
"browserInfo": {
"userAgent": "string",
"acceptHeader": "string",
"language": "string",
"colorDepth": 0,
"screenHeight": 0,
"screenWidth": 0,
"timezoneOffset": 0,
"javaEnabled": true,
"javaScriptEnabled": true
},
"emailFingerprint": "string",
"phoneFingerprint": "string",
"emailDomain": "string"
},
"agenticContext": {
"channel": "acp",
"trustLayers": [
"visa_tap"
],
"agentVerification": {
"status": "verified",
"keyId": "string",
"tag": "agent-browser-auth",
"provider": "visa_tap",
"verifiedAt": "string"
},
"consumerRecognition": {
"recognized": true,
"visaSubjectId": "string",
"matchedCustomerId": "string",
"hasSavedCards": true,
"maskedPhone": "string",
"maskedEmail": "string"
},
"mandate": {
"cartMandateId": "string",
"paymentMandateId": "string",
"intentMandateId": "string",
"modality": "human_present"
},
"sptId": "string",
"riskSignals": [
{
"source": "acp",
"type": "string",
"score": 0,
"action": "allow"
}
]
},
"createdAt": "string",
"expiresAt": "string",
"updatedAt": "string",
"deletedAt": null,
"metadata": {
"property1": "string",
"property2": "string"
}
}
}Create checkout session
Creates a hosted-payment-page (HPP) / widget checkout session. Requires a secret-key (sk_*) authenticated caller. The `Idempotency-Key` header is REQUIRED and is used for request deduplication (not the optional body field of the same name). The response includes a one-time `clientSecret` (cs_secret_*) the merchant must hand to the buyer so the HPP/widget can authenticate against `GET /v1/checkout-sessions/current`.
Get current checkout session (HPP)
Returns the checkout session referenced by the calling `clientSecret` Bearer token. Used by the hosted-payment-page (HPP) and widget SDKs at render time so they can display line items, totals, and available payment methods. Authentication is clientSecret-based — the session ID is derived from the token, NOT passed in the URL. Returns 403 when the caller is not authenticated with a clientSecret.