Requests verification code and password from provider. Updates purchase status to SUCCESS.
Idempotent Operation. Safe to retry on network errors - will not generate duplicate codes.
Behavior.
SUCCESSGET /purchases/:id to retrieve existing code)Provider timeout. Code retrieval may take 5-30 seconds depending on provider availability.
Webhook notification. Optionally provide callback_url to receive a POST webhook when code is retrieved. See Webhooks section for payload structure and Models section for WebhookSuccessPayload / WebhookFailedPayload schemas.
API-key that you received from Telegram Bot.
Unique purchase identifier.
1 <= x <= 900719925474099112345
URL to receive webhook notification when code is received. POST request will be sent with either WebhookSuccessPayload or WebhookFailedPayload.
Retry policy. If your endpoint does not return HTTP 200, webhook will be retried up to 3 times with delays: immediately, after 10 seconds, after 30 seconds. Any non-200 response triggers retry.
"https://example.com/webhooks/code-received"