---
title: "Card Charge"
method: POST
path: "/api/b2b/fiat/deposit/card"
---

# Card Charge

`POST /api/b2b/fiat/deposit/card`

## Request

- Base URL: `https://api-v2.honeycoin.app`
- URL: `https://api-v2.honeycoin.app/api/b2b/fiat/deposit/card`
- Auth: API key in header `Authorization`

Start a card payment transaction by sending the customer's card details and transaction information.

## Request body

- object
  - `amount` number, float, required
  - `currency` string, required: 3-letter currency code (e.g., NGN, USD).
  - `ipAddress` string, required: The user's ip address.
  - `email` string, required: Customer's email address.
  - `firstName` string, required: Customer's first name
  - `lastName` string, required: Customer's last name
  - `externalReference` string, required: A unique ID of your liking to reconcile transactions internally.
  - `cardDetails` object, required: Card details object
    - `cvv` string, required: Card CVV
    - `number` string, required: Card PAN
    - `expMonth` string, required: Expiry month (MM)
    - `expYear` string, required: Expiry year (YY)
  - `address` object: Billing address (required for some international cards)
    - `street1` string, required
    - `street2` string
    - `city` string, required
    - `country` string, required: ISO 3166-1 alpha-2 code
    - `postalCode` string
    - `state` string, required
  - `device3DSInfo` object: Required for some currencies e.g USD
    - `colorDepth` integer, required: Screen color depth
    - `screenHeight` integer, required: Screen height in pixels
    - `screenWidth` integer, required: Screen width in pixels
    - `timeZone` integer, required: Timezone offset in minutes
    - `deviceId` string, required: Unique device identifier
    - `userAgent` string: Browser user agent string
  - `successRedirectUrl` string: The redirect url for a successful transaction
  - `failureRedirectUrl` string, uri: Optional URL to return the customer to after a failed payment.

## Response `200`

200

- object
  - `success` boolean
  - `message` string
  - `data` object
    - `transactionId` string

## Other responses

- `400`: 400

## Changes

- **2026-11-03** `fcb58b0ef441`: 1 breaking, 2 info
  - the request property `address/state` became required
  - added the new optional request property `failureRedirectUrl`
  - the request property `device3DSInfo/userAgent` became optional

[Operation history](https://skmtc.dev/honeycoin/apis/honeycoin-v3-api-official/changes/api/b2b/fiat/deposit/card/post.md)

---

[API](https://skmtc.dev/honeycoin/apis/honeycoin-v3-api-official.md) - [All operations](https://skmtc.dev/honeycoin/apis/honeycoin-v3-api-official/llms.txt) - [OpenAPI document](https://skmtc.dev/honeycoin/apis/honeycoin-v3-api-official/revisions/fcb58b0ef441?raw)