Partner API
  1. Payment link & Checkout Link
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
          POST
        • Generate Hosted Checkout
          POST
        • Get Payment Link Details
          GET
    • User Operations
      • Onboarding & KYC Flow
        • Create User Account
        • Method A: Add KYC File
        • Method B: Creating KYC Verification
        • Method B: Redirect to Verification
        • Method B: Get KYC Status
        • Add User Verification
        • Add POA File
      • 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. Payment link & Checkout Link

Get Payment Link Details

Testing
Testing Env
https://partner-api-stage.p100.io
Testing Env
https://partner-api-stage.p100.io
GET
/v1/payment-link/{paymentLinkId}
This endpoint retrieves the comprehensive status and full history of a payment link. The architecture separates the high-level business state from the technical blockchain events:
Payment Link Status (Root): Represents the overall state of the payment process. A link remains in the initial state until the full amount is confirmed or the time expires.
Transaction History (Nested): The transactions array tracks every blockchain transfer detected. These entries provide granular technical details, such as network confirmations and risk analysis, for each individual payment attempt.
Payment Lifecycle Flow:
After a payment link is created, it is assigned the PENDING status. It transitions to SUCCESSFUL once the user correctly completes the payment. If the link’s time limit is reached, it becomes EXPIRED. If a user starts a payment but does not finish it (for example, by not sending the full required amount), the link remains in the PENDING state.
Service Fulfillment
Release your products or services only when the root-level status is SUCCESSFUL. This state guarantees that the total requested amount has been received, confirmed on the blockchain, and fully settled.

Request

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

Responses

🟢200Success
application/json
Body

🟠400P500: Unknown exception
🟠400P501: Service temporarily unavailable
🟠401Access Denied
🟠404P464: Payment link not found
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://partner-api-stage.p100.io/v1/payment-link/21c00033-a5b0-4a28-9fd5-f7db2f1058a8' \
--header 'x-api-key: <api-key>'
Response Response Example
200 - Success
{
    "paymentLinkId": "a44a0805-dd40-4dc4-80d7-8bc81783ec42",
    "url": "https://p100-payment-link.io/123456789",
    "status": "WAITING_FOR_CONFIRMATION",
    "createdAt": "2025-08-31T21:21:35.840Z",
    "expiresAt": "2025-08-31T21:21:35.840Z",
    "confirmations": 1,
    "requiredConfirmations": 3,
    "receivedAmount": 849.39,
    "totalAmountRequired": 1000,
    "cryptocurrency": "USDC",
    "walletAddress": "bc1x0000000000000000"
}
Previous
Generate Hosted Checkout
Next
User Operations
Built with