Cryptopay API
  • Welcome
  • Guides
    • Introduction
    • Environments
    • Creating a Test Account
    • API Credentials
    • API Basics
      • Responses
      • Date formats
      • Authentication
        • How it works
        • Signature
        • Creating a signature. Code samples
      • Callbacks
    • API Client Libraries
    • API Reference
    • Cryptocurrency Payments
    • Currencies
      • Supported Currencies
      • Currency Icons
    • Confirmations
    • Tools for accepting payments
    • Prebuilt integrations
      • E-commerce payment plugins
      • Payment and software providers
    • Channels
      • Channel payment
      • Payment statuses
      • Channel payment sequence
      • Create a Channel
      • Visual representation at Cashier
      • Channel hosted page
      • Channel payment callbacks
    • Invoices
      • Invoice statuses
      • Invoice payment sequence
      • How to handle unresolved invoices
        • Underpaid
        • Overpaid
        • Paid late
        • Illicit resource
        • Invoice refunds sequence
      • Create an invoice
      • Visual presentation at Cashier
      • Invoice hosted page
      • Online checkout
        • How-to
      • Payment links
      • Invoice callbacks
    • Payouts
      • Payout statuses
      • Payout sequence
      • Payout fees consideration
        • Network fees
      • Create a Coin Withdrawal
        • Possible errors
        • Withdrawals from fiat accounts
        • Withdrawals from cryptocurrency accounts
        • high_risk_address error message
      • Visual representation at Cashier
      • Minimum transaction amount
      • Coin Withdrawal callbacks
      • Travel Rule Compliance
    • Email Billing
      • Create an email billing
      • Email billing callbacks
    • Testing
      • Channels
      • Invoices
      • Payouts
    • Risks
    • Customers
    • Transactions types and Statuses
Powered by GitBook
On this page
  1. Guides
  2. Payouts

Coin Withdrawal callbacks

PreviousMinimum transaction amountNextTravel Rule Compliance

Last updated 3 months ago

Handling callbacks correctly is crucial to make sure your integration’s business logic works as expected. It is highly recommended to validate payment statuses and callbacks before acting on it inside your system.

Refer to to get more information on what callbacks are and how to validate them before acting on it inside your system.

Event

Description

created

A CoinWithdrawal transaction has been created

status_changed

The CoinWithdrawal transaction has changed its status

Refer to to get more information on CoinWithdrawal transaction statuses.

{
  "type": "CoinWithdrawal",
  "event": "created",
  "data": {
    "id": "09968790-5f14-442d-a9a4-0c2bd09e0766",
    "custom_id": "CP39563937491",
    "customer_id": null,
    "address": "2MvavRrBCRVUm9JNSGmukeBWzU3A1ACvJne",
    "network": "bitcoin",
    "txid": null,
    "status": "pending",
    "charged_amount": "10.17",
    "charged_currency": "EUR",
    "received_amount": "0.00105461",
    "received_currency": "BTC",
    "network_fee": "0.0000054",
    "network_fee_level": "fast",
    "fee": "0.0",
    "fee_currency": "BTC",
    "exchange": {
      "fee": "20.21",
      "pair": "BTCEUR",
      "rate": "9482.0979",
      "fee_currency": "EUR"
    },
    "risk": null,
    "created_at": "2020-02-07T09:07:26+00:00"
  }
}
{
  "type": "CoinWithdrawal",
  "event": "status_changed",
  "data": {
    "id": "09968790-5f14-442d-a9a4-0c2bd09e0766",
    "custom_id": "CP39563937491",
    "customer_id": null,
    "address": "2MvavRrBCRVUm9JNSGmukeBWzU3A1ACvJne",
    "network": "bitcoin",
    "txid": null,
    "status": "processing",
    "charged_amount": "10.17",
    "charged_currency": "EUR",
    "received_amount": "0.00105461",
    "received_currency": "BTC",
    "network_fee": "0.0000054",
    "network_fee_level": "fast",
    "fee": "0.0",
    "fee_currency": "BTC",
    "exchange": {
      "fee": "20.21",
      "pair": "BTCEUR",
      "rate": "9482.0979",
      "fee_currency": "EUR"
    },
    "risk": null,
    "created_at": "2020-02-07T09:07:26+00:00"
  }
}
{
  "type": "CoinWithdrawal",
  "event": "status_changed",
  "data": {
    "id": "09968790-5f14-442d-a9a4-0c2bd09e0766",
    "custom_id": "CP39563937491",
    "customer_id": null,
    "address": "2MvavRrBCRVUm9JNSGmukeBWzU3A1ACvJne",
    "network": "bitcoin",
    "txid": "c01d93c268ee884f09c586c89340ed35b5b05fba5a1bb726924f2dd1eb9319b6",
    "status": "completed",
    "charged_amount": "10.17",
    "charged_currency": "EUR",
    "received_amount": "0.00105461",
    "received_currency": "BTC",
    "network_fee": "0.0000054",
    "network_fee_level": "fast",
    "fee": "0.0",
    "fee_currency": "BTC",
    "exchange": {
      "fee": "20.21",
      "pair": "BTCEUR",
      "rate": "9482.0979",
      "fee_currency": "EUR"
    },
    "risk": null,
    "created_at": "2020-02-07T09:07:26+00:00"
  }
}

this section
this section