Transactions

Use this API to create and get transactions for a customer and a quote. Requires the creation of a quote beforehand per transaction.

Create transaction

post

Create a transactionCreates a transaction using a given quoteID. QuoteID must be valid and not expired.

Authorizations

Header parameters

x-idempotency-keystringRequired

Body

Schema for creating a new transaction

quoteIdstring · uuidRequired

Identifier of the quote to initiate the transaction

Example: c88ebfc2-3356-48b5-b2bb-6fca7b618c96

correlationIdstringOptional

Optional: You can add your own correlationId to match the transaction to your own internal records.

Example: 03b7030f-6da1-4e76-3352-3debd82112c8

Responses

post

HTTPcURLJavaScriptPython

POST /transactions HTTP/1.1
Host: api.fernhq.com
Authorization: Bearer API Key
x-idempotency-key: text
Content-Type: application/json
Accept: */*
Content-Length: 105

{
  "quoteId": "c88ebfc2-3356-48b5-b2bb-6fca7b618c96",
  "correlationId": "03b7030f-6da1-4e76-3352-3debd82112c8"
}

{
  "transactionId": "1d8beb26-b4d1-47ee-8e5d-0d3905f200c7",
  "transactionStatus": "PROCESSING",
  "correlationId": "03b7030f-6da1-4e76-3352-3debd82112c8",
  "source": {
    "sourcePaymentAccountId": "072a8b7b-38c7-429a-a6cf-35dae7f2fb77",
    "sourceCurrency": "USD",
    "sourcePaymentMethod": "ACH",
    "sourceAmount": "100.00"
  },
  "destination": {
    "destinationPaymentAccountId": "072a8b7b-38c7-429a-a6cf-35dae7f2fb77",
    "destinationPaymentMethod": "ETHEREUM",
    "destinationCurrency": "USDC",
    "exchangeRate": "1.2",
    "destinationAmount": "100",
    "minGuaranteedDestinationAmount": "98"
  },
  "fees": {
    "feeCurrency": "5.50",
    "fernFee": {
      "feeAmount": "5.45",
      "feeUSDAmount": "5.45"
    },
    "developerFee": {
      "feeAmount": "5.45",
      "feeUSDAmount": "5.45"
    }
  },
  "transferInstructions": {
    "type": "fiat",
    "transferPaymentMethod": "ACH",
    "transferMessage": "Payment for order #12345",
    "transferBankName": "First National Bank",
    "transferBankAddress": "123 Bank St, Finance City",
    "transferBankAccountNumber": "987654321",
    "transferACHRoutingNumber": "123456789",
    "transferWireRoutingNumber": "123456789",
    "transferBankBeneficiaryName": "John Doe"
  },
  "createdAt": "2023-08-01T12:00:00Z",
  "updatedAt": "2023-08-01T12:00:00Z"
}

Get transaction

get

Get a transaction by ID

Authorizations

Path parameters

transactionIdstring · uuidRequired

Unique identifier of the transaction

Example: 1d8beb26-b4d1-47ee-8e5d-0d3905f200c7

Responses

get

HTTPcURLJavaScriptPython

GET /transactions/{transactionId} HTTP/1.1
Host: api.fernhq.com
Authorization: Bearer API Key
Accept: */*

{
  "transactionId": "1d8beb26-b4d1-47ee-8e5d-0d3905f200c7",
  "transactionStatus": "PROCESSING",
  "correlationId": "03b7030f-6da1-4e76-3352-3debd82112c8",
  "source": {
    "sourcePaymentAccountId": "072a8b7b-38c7-429a-a6cf-35dae7f2fb77",
    "sourceCurrency": "USD",
    "sourcePaymentMethod": "ACH",
    "sourceAmount": "100.00"
  },
  "destination": {
    "destinationPaymentAccountId": "072a8b7b-38c7-429a-a6cf-35dae7f2fb77",
    "destinationPaymentMethod": "ETHEREUM",
    "destinationCurrency": "USDC",
    "exchangeRate": "1.2",
    "destinationAmount": "100",
    "minGuaranteedDestinationAmount": "98"
  },
  "fees": {
    "feeCurrency": "5.50",
    "fernFee": {
      "feeAmount": "5.45",
      "feeUSDAmount": "5.45"
    },
    "developerFee": {
      "feeAmount": "5.45",
      "feeUSDAmount": "5.45"
    }
  },
  "transferInstructions": {
    "type": "fiat",
    "transferPaymentMethod": "ACH",
    "transferMessage": "Payment for order #12345",
    "transferBankName": "First National Bank",
    "transferBankAddress": "123 Bank St, Finance City",
    "transferBankAccountNumber": "987654321",
    "transferACHRoutingNumber": "123456789",
    "transferWireRoutingNumber": "123456789",
    "transferBankBeneficiaryName": "John Doe"
  },
  "createdAt": "2023-08-01T12:00:00Z",
  "updatedAt": "2023-08-01T12:00:00Z"
}

List transactions

get

List all transactions for a customer

Authorizations

Query parameters

pageTokenstringOptional

Page token to fetch entries after

Example: abc

pageSizeinteger · min: 1 · max: 100Optional

Number of entries to fetch

Example: 10

customerIdstring · uuidOptional

Customer to list transaction for

Example: 072a8b7b-38c7-429a-a6cf-35dae7f2fb77

Responses

get

HTTPcURLJavaScriptPython

GET /transactions HTTP/1.1
Host: api.fernhq.com
Authorization: Bearer API Key
Accept: */*

{
  "transactions": [
    {
      "transactionId": "1d8beb26-b4d1-47ee-8e5d-0d3905f200c7",
      "transactionStatus": "PROCESSING",
      "correlationId": "03b7030f-6da1-4e76-3352-3debd82112c8",
      "source": {
        "sourcePaymentAccountId": "072a8b7b-38c7-429a-a6cf-35dae7f2fb77",
        "sourceCurrency": "USD",
        "sourcePaymentMethod": "ACH",
        "sourceAmount": "100.00"
      },
      "destination": {
        "destinationPaymentAccountId": "072a8b7b-38c7-429a-a6cf-35dae7f2fb77",
        "destinationPaymentMethod": "ETHEREUM",
        "destinationCurrency": "USDC",
        "exchangeRate": "1.2",
        "destinationAmount": "100",
        "minGuaranteedDestinationAmount": "98"
      },
      "fees": {
        "feeCurrency": "5.50",
        "fernFee": {
          "feeAmount": "5.45",
          "feeUSDAmount": "5.45"
        },
        "developerFee": {
          "feeAmount": "5.45",
          "feeUSDAmount": "5.45"
        }
      },
      "transferInstructions": {
        "type": "fiat",
        "transferPaymentMethod": "ACH",
        "transferMessage": "Payment for order #12345",
        "transferBankName": "First National Bank",
        "transferBankAddress": "123 Bank St, Finance City",
        "transferBankAccountNumber": "987654321",
        "transferACHRoutingNumber": "123456789",
        "transferWireRoutingNumber": "123456789",
        "transferBankBeneficiaryName": "John Doe"
      },
      "createdAt": "2023-08-01T12:00:00Z",
      "updatedAt": "2023-08-01T12:00:00Z"
    }
  ],
  "nextPageToken": "xyz"
}