Payland API v2
    • API Response Codes and Messages
    • Credit Card Info & Test Cards
    • Withdraw Info
    • Deposit
      • Create Deposit (Bank Transfer)
        POST
      • Create Deposit (Credit Card)
        POST
      • Create Deposit (Crypto)
        POST
      • Check Deposit Status
        GET
    • Withdraw
      • Create Withdraw (Bank Transfer)
        POST
      • Check Withdrawal Status
        GET
    • Callback
      • Callback Request
        POST

    API Response Codes and Messages

    HTTP Status Codes#

    Success Codes#

    200 OK: Request completed successfully
    201 Created: Resource created successfully

    Error Codes#

    400 Bad Request: Invalid request
    401 Unauthorized: Authentication error
    404 Not Found: Resource not found
    422 Unprocessable Entity: Validation error or business logic error
    500 Internal Server Error: Server error

    Authentication#

    401 Unauthorized#

    Message: Invalid API credentials

    Banks API#

    GET /api/v2/banks#

    200 OK: Success

    Deposits API#

    POST /api/v2/deposit#

    200 OK: Success
    422 Unprocessable Entity:
    The given data was invalid
    The transaction_id has already been taken for this merchant.
    Please wait 3 minutes between deposit requests.
    You have a pending deposit with the same name. Please complete or cancel it first.
    Merchant does not have an active wallet for the requested currency [CURRENCY].
    No active payment method available
    Validation failed
    No active dealer found for this payment method.
    No suitable payment method found or provider initiation failed: [PROVIDER_MESSAGE]
    Payment initiation failed

    GET /api/v2/deposit/status/{transactionId}#

    POST /api/v2/deposit/status#

    200 OK: Success
    404 Not Found: Transaction not found

    GET /api/v2/transactions/{hashedTransactionId}/initPay#

    200 OK: Success
    404 Not Found:
    Transaction not found
    Provider not found
    Provider error message

    GET /api/v2/transactions/{hashedTransactionId}/detail#

    200 OK: Success
    404 Not Found: Transaction not found

    Withdrawals API#

    POST /api/v2/withdraw#

    201 Created: Withdrawal request created successfully.
    422 Unprocessable Entity:
    Validation errors
    No suitable payment provider found for this request.
    No suitable payment method found or provider initiation failed: [PROVIDER_MESSAGE]
    An error occurred while processing your request.

    GET /api/v2/withdraw/status/{transactionId}#

    POST /api/v2/withdraw/status#

    200 OK: Success
    404 Not Found: Transaction not found
    Modified at 2026-02-16 17:33:55
    Next
    Credit Card Info & Test Cards
    Built with