Partner API
  1. Onboarding & KYC Flow
Partner API
  • Getting Started
    • Introduction
    • Authentication
    • Business Use Cases
  • API References
    • Partner Operations
      • Balances & Transaction History
        • Get Balances
        • Get Transaction History
        • Create Wallet
      • Currency Exchange
        • Retrieve Exchange Rate
        • Retrieve Exchange Rate and Create a Lock
        • Create and Finalize an Exchange
        • Retrieve Detailed Exchange Information
      • SEPA Transfers
        • Get SEPA Deposit Info
        • Get SEPA Deposit Contact List
        • Create a SEPA Transfer
        • Get SEPA Transfer Details
      • Crypto Withdrawal
        • Get Network Fee
        • Create Crypto Withdrawal
        • Get Crypto Withdrawal Details
      • Crypto Deposits
        • Update Travel Rule
      • Orders
        • Get Rates
        • Retrieve Order Rate and Create a Lock
        • Create and Finalize an Order
        • Get Order Details
      • Payment link & Checkout Link
        • Generate Payment Link
        • Generate Hosted Checkout
        • Get Payment Link Details
    • User Operations
      • Onboarding & KYC Flow
        • Create User Account
          POST
        • Method A: Add KYC File
          POST
        • Method B: Creating KYC Verification
          POST
        • Method B: Redirect to Verification
          GET
        • Method B: Get KYC Status
          GET
        • Add User Verification
          POST
        • Add POA File
          POST
      • Account Management
        • Update Existing User
        • Delete User
        • Suspend User
        • Unsuspend User
      • Balances & Transaction History
        • Get User Balances
        • Get User Transaction History
      • Currency Exchange
        • Retrieve Exchange Rate
        • Retrieve Exchange Rate and Create a Lock
        • Create and Finalize an Exchange
        • Retrieve Detailed Exchange Information
      • SEPA Transfers
        • Get SEPA Deposit Info
        • GET SEPA Deposit Contact List
        • Create a SEPA Transfer
        • Get SEPA Transfer Details
      • Crypto Withdrawal
        • Get Network Fee
        • Create Crypto Withdrawal
        • Get Crypto Withdrawal Details
      • Crypto Deposits
        • Update Travel Rule
      • Internal Transfers
        • Create a Transfer
        • Get Transfer Details
      • Virtual Cards
        • Create Virtual Card
        • Get All User Cards
        • Get Card Details
        • Update Card PIN
        • Block Card
        • Unblock Card
        • Get Card Limits
        • Update Card Limits
        • Delete Card
  • Integration
    • SDKs & Integration Guides
    • Transaction Processing
    • Error Handling
    • Rate Limiting
    • Webhooks
      • User & KYC Webhooks
        • User Balance Generation Webhook
        • KYC File Added Webhook
        • POA Verification Status Webhook
        • KYC Verification Status Webhook
        • Create Wallet Webhook
      • Transfers & Payments Webhooks
        • P2P Transfer Webhook
        • Partner SEPA Transfer Webhook
        • User SEPA Transfer Webhook
        • SEPA Deposit Webhook
        • Crypto Withdrawal Webhook
        • Crypto Deposit Webhook
        • Exchange Webhook
        • Card Transaction Webhook
        • Order status Webhook
        • Payment Link Webhook
      • Card Webhooks
        • Card 3DS Code Webhook
        • Card Activation Code Webhook
  • Reference
    • Supported Countries
    • Supported Currencies
    • Fees
    • FAQ
    • Changelog
    • Support
  1. Onboarding & KYC Flow

Method B: Redirect to Verification

Testing Env
https://partner-api-stage.p100.io
Testing Env
https://partner-api-stage.p100.io
GET
/v1/kyc/verification/{externalUserId}/{verificationId}
This endpoint is used to redirect the user to the P100 hosted page where they can complete their KYC verification. You should redirect your user's browser to the URL generated by this endpoint. The verification page guides the user through the process of uploading necessary documents and confirming their identity.

Request

Authorization
API Key
Add parameter in header
x-api-key
Example:
x-api-key: ********************
or
Path Params

Responses

🟢200Success
text/html

Response Behavior

When this endpoint is called, the API's behavior is as follows:
1.
You will receive an HTTP 200 OK response.
2.
The response body will contain raw HTML content for a loading page (e.g., <html>...</html>)
3.
The actual redirection to the verification session does not occur via a standard HTTP 302 redirect or a Location header. Instead, the user's browser is redirected through embedded logic and a series of redirect chains handled by the verification service.

How to Obtain the Redirect URL

To correctly redirect your user to the iDenfy verification session, you must capture the final URL from the network redirect chain. This URL is not available in the initial response body or headers. It can be captured using browser developer tools or a network inspection proxy.
Example Flow
The network flow will look similar to this:
1.
Initial Request:
GET https://partner-api-stage.p100.io/v1/kyc/verification/6ef2fb57.../1306fc1d...
2.
Final Redirect URL (Target):
GET https://ui.idenfy.com/?authToken=wosP8TruRQm...&country=de
To properly redirect your user, you must use the final URL from this chain.
Important Notes
If you test this endpoint in tools like Apidog or Postman, you will see the raw HTML of the initial loading page in the response body.
Do not attempt to copy and open this HTML content directly in a browser, as it will not work.
You must capture the final redirect URL from the network flow and use that URL to redirect your user.
🟠404P412: User not exist
🟠404P445: KYC not found
🟠400P500: Unknown exception
🟠400P501: Service temporarily unavailable
🟠400P459: User not verified
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://partner-api-stage.p100.io/v1/kyc/verification/aeb997d7-e22d-4456-bdc7-7a78a08bb1fe/18d234d0-9b43-4540-a87d-571741535b00' \
--header 'x-api-key: <api-key>'
Response Response Example
404 - P412
{
    "errorCode": "P412",
    "errorMessage": "User not found",
    "name": "invalid-user"
}
Previous
Method B: Creating KYC Verification
Next
Method B: Get KYC Status
Built with