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

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

Request body

amountnumber float required
currencystring required

3-letter currency code (e.g., NGN, USD).

ipAddressstring required

The user's ip address.

emailstring required

Customer's email address.

firstNamestring required

Customer's first name

lastNamestring required

Customer's last name

externalReferencestring required

A unique ID of your liking to reconcile transactions internally.

successRedirectUrlstring

The redirect url for a successful transaction

failureRedirectUrlstring uri

Optional URL to return the customer to after a failed payment.

Response

200

successboolean
messagestring

Example response

{
  "success": true,
  "message": "Card charge initiated",
  "data": {
    "transactionId": "OD2bmfdvLSv1chSVtdss"
  }
}

Changes

    • breaking

      the request property / became required

    • info

      added the new optional request property

    • info

      the request property / became optional