Ideal for companies that have verified users through their own identity verification (IDV) provider.
How It Works
Crossmint relies on your company running KYC, ID verification, and liveness checks with your own IDV provider (such as Persona or Sumsub). You then share the full KYC data with Crossmint via API. In order to complete orders, Crossmint runs sanction and PEP (Politically Exposed Persons) screens, and performs ongoing monitoring to ensure compliance.
Register User with Full KYC Data
Check the requirements here, on what information needs to be attached to the user using the Create User API.
Create an Onramp Order
Once the user is registered with their KYC data, you can create an onramp order. The order will use the registered KYC data for compliance checks.
curl --request POST \
--url https://staging.crossmint.com/api/2022-06-09/orders \
--header 'X-API-KEY: <x-api-key>' \
--header 'Content-Type: application/json' \
--data '{
"recipient": {
"walletAddress": "<recipient-wallet-address>"
},
"payment": {
"method": "card",
"receiptEmail": "johnd@example.com"
},
"lineItems": [
{
"tokenLocator": "base-sepolia:0x036CbD53842c5426634e7929541eC2318f3dCF7e",
"executionParameters": {
"mode": "exact-in",
"amount": "1"
}
}
]
}'
The lineItems field accepts both a single object or an array. The examples above use an array for consistency, but you can also pass a single line item object directly.
Order Responses
Success: Full KYC Data Present
When all required KYC data has been provided and validated, the order moves to the payment phase:
{
"clientSecret": "...",
"order": {
"orderId": "987e81ab-8c8f-464e-95e9-11ceda80d559",
"phase": "payment",
"locale": "en-US",
"lineItems": [...],
"quote": {...},
"payment": {
"method": "card",
"currency": "usd",
"status": "awaiting-payment"
}
}
}
Success: Additional KYC Inquiry
When full KYC data is present but Crossmint needs to run additional compliance checks, the order enters a processing state. This typically resolves within a few seconds as Crossmint runs the appropriate checks:
{
"clientSecret": "...",
"order": {
"orderId": "987e81ab-8c8f-464e-95e9-11ceda80d559",
"phase": "payment",
"locale": "en-US",
"lineItems": [...],
"quote": {...},
"payment": {
"method": "card",
"currency": "usd",
"status": "processing-kyc-verification"
}
}
}
Error: Missing KYC Data
If no user personal data is provided, or if the data is insufficient, the order will fail:
{
"error": true,
"message": "Required full KYC user data is missing to complete the order"
}
Next Steps
