Skip to main content
POST
https://services-staging.bitmama.io/api
/
v1
/
partner
/
profile
/
redirect-url
curl -X POST https://services-staging.bitmama.io/api/v1/partner/profile/redirect-url \
  -H "Authorization: Bearer sk_staging_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "redirectUrl": "https://app.acme.com/kyc-complete"
  }'

{
  "status": "success",
  "message": "Redirect URL configured",
  "data": {
    "redirectUrl": "https://app.acme.com/kyc-complete"
  }
}
Set where users are redirected after completing Persona KYC verification. The redirect URL receives a referenceId query parameter containing the user’s serviceId.
​
Authorization
string
required
Bearer token. Example: Bearer sk_staging_your_api_key
​
redirectUrl
string
required
HTTPS URL to redirect users after KYC. Max 2048 characters.
curl -X POST https://services-staging.bitmama.io/api/v1/partner/profile/redirect-url \
  -H "Authorization: Bearer sk_staging_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "redirectUrl": "https://app.acme.com/kyc-complete"
  }'

{
  "status": "success",
  "message": "Redirect URL configured",
  "data": {
    "redirectUrl": "https://app.acme.com/kyc-complete"
  }
}
After KYC, the user is redirected to: 
https://app.acme.com/kyc-complete?referenceId=acme-rain-user-abc123def456ghi
Use the referenceId to look up the user’s status via Get Profile or listen for KYC webhook events.