We can configure up to two callback URLs — please inform the Pay2Free team which endpoints should be used.
How do the callbacks work?
We send callbacks to the configured endpoints with information about the user's current step in the flow.
Pay2Free provides an API key that is essential for validating incoming callbacks. It is strictly important to verify that the received API key matches the one provided.
First, let's understand: Biometric identification status
| status | |
|---|---|
| requested | When the user accesses the liveness URL or restarts the flow |
| processing | When the user taps to continue the flow |
| failed | When biometric identification fails |
| validated | When biometric identification is completed successfully |
Biometric identification Callbacks
Callbacks will be send as the user progresses through the biometric flow, with only the status field being updated
{
"correlation_id":"9876543",
"transaction_id":"847656ee-9cf7-4322-b3db-887aad303a1e",
"document":"70469605006",
"createdAt":"2025-03-13T13:19:57.641Z",
"updatedAt":"2025-04-10T19:51:23.310Z",
"status":"validated",
"event":"user_password_change",
"type":"biometric_identification"
}