Skip to main content

Card Webhooks

Event Types​

Event TypeDescription
card_addedA new credit card has been added to an account
card_status_updatedThe status of a credit card has changed
card_deletedA credit card has been deleted from an account
card_transaction_createdA new card transaction has been initiated
card_transaction_status_updatedThe status of a card transaction has changed

Card Events​

Card Added​

{
    "webhookId": "00000000-0000-0000-0000-000000000000",
    "type": "card_added",
    "accountId": "00000000-0000-0000-0000-000000000000",
    "timestamp": "2025-01-01T00:00:00Z",
    "details": {
        "cardId": "11111111-1111-1111-1111-111111111111",
        "accountId": "00000000-0000-0000-0000-000000000000",
        "last4": "1111",
        "brand": "visa",
        "cardHolderName": "John Wick",
        "expMonth": 12,
        "expYear": 2026,
        "status": "pending_verification"
    },
    "systemNotes": "Do not rely solely on this webhook for final state. Always verify the current status via the API to ensure consistency. Consult the developer documentation and guides for more information."
}

Card Status Updated​

{
    "webhookId": "00000000-0000-0000-0000-000000000000",
    "type": "card_status_updated",
    "accountId": "00000000-0000-0000-0000-000000000000",
    "timestamp": "2025-01-01T00:00:00Z",
    "details": {
        "cardId": "11111111-1111-1111-1111-111111111111",
        "accountId": "00000000-0000-0000-0000-000000000000",
        "last4": "1111",
        "brand": "visa",
        "status": "active",
        "previousStatus": "pending_verification"
    },
    "systemNotes": "Do not rely solely on this webhook for final state. Always verify the current status via the API to ensure consistency. Consult the developer documentation and guides for more information."
}

Card Deleted​

{
    "webhookId": "00000000-0000-0000-0000-000000000000",
    "type": "card_deleted",
    "accountId": "00000000-0000-0000-0000-000000000000",
    "timestamp": "2025-01-01T00:00:00Z",
    "details": {
        "cardId": "11111111-1111-1111-1111-111111111111",
        "accountId": "00000000-0000-0000-0000-000000000000",
        "last4": "1111",
        "brand": "visa"
    },
    "systemNotes": "Do not rely solely on this webhook for final state. Always verify the current status via the API to ensure consistency. Consult the developer documentation and guides for more information."
}

Card Transaction Events​

Card Transaction Created​

{
    "webhookId": "00000000-0000-0000-0000-000000000000",
    "type": "card_transaction_created",
    "accountId": "00000000-0000-0000-0000-000000000000",
    "timestamp": "2025-01-01T00:00:00Z",
    "details": {
        "transactionId": "22222222-2222-2222-2222-222222222222",
        "cardId": "11111111-1111-1111-1111-111111111111",
        "accountId": "00000000-0000-0000-0000-000000000000",
        "quantity": "100.00",
        "coin": "USDC",
        "status": "pending",
        "estimatedQuoteQuantity": "97.00",
        "estimatedFee": "2.50",
        "estimateNetworkFee": "0.50"
    },
    "systemNotes": "Do not rely solely on this webhook for final state. Always verify the current status via the API to ensure consistency. Consult the developer documentation and guides for more information."
}

Card Transaction Status Updated​

{
    "webhookId": "00000000-0000-0000-0000-000000000000",
    "type": "card_transaction_status_updated",
    "accountId": "00000000-0000-0000-0000-000000000000",
    "timestamp": "2025-01-01T00:00:00Z",
    "details": {
        "transactionId": "22222222-2222-2222-2222-222222222222",
        "cardId": "11111111-1111-1111-1111-111111111111",
        "accountId": "00000000-0000-0000-0000-000000000000",
        "quantity": "100.00",
        "coin": "USDC",
        "status": "completed",
        "previousStatus": "pending",
        "actualQuoteQuantity": "97.00",
        "actualFee": "2.50",
        "actualNetworkFee": "0.50"
    },
    "systemNotes": "Do not rely solely on this webhook for final state. Always verify the current status via the API to ensure consistency. Consult the developer documentation and guides for more information."
}

Support and Resources​

If you need assistance or have any questions, our support team is here to help. You can contact our support team at support@blockwyre.com.

Stay Updated​

Stay up-to-date with the latest news, updates, and features from BlockWyre by following us on social media:

We are excited to have you on board and look forward to seeing how you leverage BlockWyre's powerful tools to enhance your financial operations. Happy integrating!