DocsAPI Reference

CryptoPoket API

Welcome to the CryptoPoket API. This documentation will help you integrate our crypto payment gateway into your application.

Introduction

The CryptoPoket API is organized around REST. We use standard HTTP response codes, authentication, and verbs. All API requests must be made over HTTPS.

Authentication

Authenticate your API requests by including your API key in the header of every request. You can manage your API keys in the Dashboard.

Header format:

CP-API-KEY: pkl_live_XXXXXXXXXXXXXXXXXXXXXXXX

Base URL

All API requests should be made to:

https://jx-api.cryptopoket.com/v1

POST

Create Invoice

Creates a new payment invoice. This is the primary method to initiate a payment.

Body Parameters

amountnumberRequired

The amount to charge in the source currency.

currencystringRequired

Three-letter ISO currency code (e.g., 'USD', 'EUR').

order_idstringRequired

Your internal unique order identifier.

emailstringRequired

Customer's email address for notifications.

Example Request

bash

curl -X POST https://jx-api.cryptopoket.com/v1/invoices \
  -H "CP-API-KEY: pkl_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 99.00,
    "currency": "USD",
    "order_id": "ORD-123",
    "email": "customer@example.com"
  }'

Example Response

json

{
  "id": "inv_897435",
  "status": "pending",
  "checkout_url": "https://pay.cryptopoket.com/i/inv_897435",
  "amount_due": "0.0034 BTC",
  "created_at": 1698245678
}

Webhooks (IPN)

CryptoPoket uses Instant Payment Notifications (IPN) to notify your application when an invoice status changes (e.g., when a payment is detected or confirmed).

Note: You must set your IPN URL in the dashboard settings before you can receive webhooks.