Skip to main content
POST
/
partner
/
cards
/
{id}
/
reveal-html
Generate card reveal iframe URL
curl --request POST \
  --url https://api.contro.me/v1/partner/cards/{id}/reveal-html \
  --header 'Content-Type: application/json' \
  --header 'x-contro-api-key: <api-key>' \
  --data '
{
  "stylesheetUrl": "https://cdn.example.com/card-styles.css",
  "copyPan": true
}
'
{
  "accessUrl": "https://api.contro.me/v1/web/partner-card-details?token=eyJ..."
}

Authorizations

​
x-contro-api-key
string
header
required

Partner API key (sk_live_* for production, sk_test_* for sandbox)

Path Parameters

​
id
string
required

Card ID

Example:

"card_def456"

Body

application/json
​
stylesheetUrl
string<uri>

HTTPS URL to custom CSS stylesheet for widget styling

Maximum string length: 2048
Example:

"https://cdn.example.com/card-styles.css"

​
copyPan
boolean
default:true

Enable click-to-copy on card fields

Response

Card reveal URL generated

​
accessUrl
string
required

Short-lived signed URL to embed as iframe src (valid 60 seconds)

Example:

"https://api.contro.me/v1/web/partner-card-details?token=eyJ..."