# Setting up API Keys

## API Fields

This article provides additional details on the various fields that must be completed when creating a new API key.

### <i class="fa-hand-point-right" style="color:$primary;">:hand-point-right:</i> Gateway Nickname

The purpose of choosing a gateway nickname: For some gateways, this can be any value used for the user’s reference. For others, it is a required part of the API key setup and must contain the gateway account number.

***

### <i class="fa-hand-point-right" style="color:$primary;">:hand-point-right:</i> Credit card Gateway

This field specifies the **processing company** responsible for handling the funds.&#x20;

***

### <i class="fa-hand-point-right" style="color:$primary;">:hand-point-right:</i> API Type

This field specifies whether you are going to process by **credit cards** or **charity cards.**&#x20;

Refer to the [API Type by Gateway](#api-type-by-gateway) table below for compatibility details.

#### <mark style="color:$primary;">**Credit Cards**</mark>

Includes all standard credit cards such as **Visa, MasterCard, American Express** etc.

#### <mark style="color:$primary;">**Charity Cards**</mark>

Charity cards are often referred to as "**DAF Cards**" (Donor advised fund cards).

Companies that issue these cards enable donors to contribute to charities while receiving tax deductions.&#x20;

Examples of providers offering charity cards include **Matbia, OJC, Donors Fund, Pledger, and OneGiv**.

Before you can connect your Donary account to your charity card accounts, you must set up accounts with each charity card.

***

### <i class="fa-hand-point-right" style="color:$primary;">:hand-point-right:</i> Processing Integration Key

This is a unique API key that connects your platform to a payment processor, allowing secure processing of payments or donations.

You will receive this key from your processing company. Copy and paste it into this field.

***

### <i class="fa-hand-point-right" style="color:$primary;">:hand-point-right:</i> Currency

Choose the correct currency to be used for these transactions.

***

### <i class="fa-hand-point-right" style="color:$primary;">:hand-point-right:</i> Country

Choose the country where the API will be used. This usually corresponds to the country selected in the **Currency** field.

***

## API Type by Gateway

Each credit card gateway supports a specific set of API types. Some gateways are compatible only with credit cards, others only with charity cards, and some support both or a partial combination.&#x20;

The table below clearly outlines the available API types for each credit card gateway:

| Gateway      | Credit Card                     | Charity Card                                                                                                   |
| ------------ | ------------------------------- | -------------------------------------------------------------------------------------------------------------- |
| CardKnox     | <i class="fa-check">:check:</i> | <i class="fa-check">:check:</i> *<mark style="color:$primary;">OJC\*\*, Pledger, DonorsFund cards only</mark>* |
| USAePay      | <i class="fa-check">:check:</i> | <i class="fa-x">:x:</i>                                                                                        |
| OJC          | <i class="fa-x">:x:</i>         | <i class="fa-check">:check:</i> *<mark style="color:$primary;">OJC card</mark>*                                |
| SequelPay    | <i class="fa-check">:check:</i> | <i class="fa-x">:x:</i>                                                                                        |
| Stripe       | <i class="fa-check">:check:</i> | <i class="fa-x">:x:</i>                                                                                        |
| Pledger      | <i class="fa-x">:x:</i>         | <i class="fa-check">:check:</i> *<mark style="color:$primary;">Pledger card\*</mark>*                          |
| Matbia       | <i class="fa-x">:x:</i>         | <i class="fa-check">:check:</i> *<mark style="color:$primary;">Matbia card\*</mark>*                           |
| DonorsFund   | <i class="fa-x">:x:</i>         | <i class="fa-check">:check:</i> *<mark style="color:$primary;">DonorsFund Card</mark>*                         |
| PeleCard     | <i class="fa-check">:check:</i> | <i class="fa-x">:x:</i>                                                                                        |
| CardCom      | <i class="fa-check">:check:</i> | <i class="fa-x">:x:</i>                                                                                        |
| ACHQ         | See more info *here*.           |                                                                                                                |
| Banquest     | <i class="fa-check">:check:</i> | <i class="fa-x">:x:</i>                                                                                        |
| Blink        | <i class="fa-check">:check:</i> | <i class="fa-x">:x:</i>                                                                                        |
| Interconnect | <i class="fa-check">:check:</i> | <i class="fa-x">:x:</i>                                                                                        |
| PayArc       | <i class="fa-check">:check:</i> | <i class="fa-x">:x:</i>                                                                                        |
| OneGiv       | <i class="fa-x">:x:</i>         | <i class="fa-check">:check:</i> *<mark style="color:$primary;">OneGiv card</mark>*                             |
| NMI          | <i class="fa-check">:check:</i> | <i class="fa-x">:x:</i>                                                                                        |

\****Pledger and Matbia API keys:*** If an API key is not set up for these charity cards, Donary can still send the payment information to the corresponding service (Pledger or Matbia) using the Tax ID to associate the payment with the correct account.

However, Donary strongly recommends using an API key whenever possible, as a Tax ID may be linked to multiple accounts, which can lead to complications.

***\*\*CardKnox - OJC API Keys:***  When processing charges through OJC and only a CardKnox-Credit Card API key is configured, the system automatically transmits the required OJC information to CardKnox — even without a dedicated CardKnox-OJC API key.

{% hint style="danger" %}
**IMPORTANT!** Ensure your CardKnox account is enabled for [DAF card ](#charity-cards)processing.
{% endhint %}

***

## Credit Card Gateway Requirements&#x20;

The table below clearly outlines the requirements and terminology for each gateway company:

<table><thead><tr><th width="208">Credit Card Gateway</th><th width="146">Nickname</th><th width="223">API Key</th><th width="245">PIN</th></tr></thead><tbody><tr><td>CardKnox</td><td></td><td><i class="fa-check">:check:</i></td><td><i class="fa-x">:x:</i></td></tr><tr><td>USAePay</td><td></td><td><i class="fa-check">:check:</i></td><td><i class="fa-check">:check:</i></td></tr><tr><td>OJC</td><td></td><td><i class="fa-check">:check:</i> **</td><td></td></tr><tr><td>SequelPay</td><td></td><td><i class="fa-check">:check:</i> </td><td><i class="fa-check">:check:</i> </td></tr><tr><td>Stripe</td><td></td><td><i class="fa-check">:check:</i></td><td><i class="fa-check">:check:</i></td></tr><tr><td>Pledger</td><td></td><td><i class="fa-check">:check:</i> **</td><td></td></tr><tr><td>Matbia</td><td></td><td><i class="fa-check">:check:</i></td><td></td></tr><tr><td>DonorsFund</td><td></td><td><i class="fa-check">:check:</i> *</td><td><i class="fa-check">:check:</i> * <em><mark style="color:$primary;">(Account no.)</mark></em></td></tr><tr><td>PeleCard (IL Gateway)</td><td><i class="fa-check">:check:</i></td><td><i class="fa-check">:check:</i></td><td><i class="fa-check">:check:</i></td></tr><tr><td>CardCom (IL Gateway)</td><td><i class="fa-check">:check:</i></td><td><i class="fa-check">:check:</i></td><td><i class="fa-check">:check:</i></td></tr><tr><td>ACHQ</td><td>See more info <em>here</em>.</td><td></td><td></td></tr><tr><td>Banquest</td><td></td><td><i class="fa-check">:check:</i></td><td><i class="fa-check">:check:</i></td></tr><tr><td>Blink (UK Gateway)</td><td></td><td><i class="fa-check">:check:</i> <em><mark style="color:$primary;">(Signature Key)</mark></em></td><td><i class="fa-check">:check:</i> <em><mark style="color:$primary;">(Gateway ID)</mark></em></td></tr><tr><td>Interconnect</td><td></td><td><i class="fa-check">:check:</i></td><td></td></tr><tr><td>PayArc</td><td></td><td><i class="fa-check">:check:</i></td><td></td></tr><tr><td>OneGiv</td><td></td><td><i class="fa-check">:check:</i></td><td></td></tr><tr><td>NMI</td><td></td><td><i class="fa-check">:check:</i></td><td></td></tr></tbody></table>

\****DonorsFund PIN:*** There is one default API key used for all DonorsFunds accounts. Please contact us with your PIN number so we can add or edit the API key.

\*\****OJC & Pledger API Key:*** Donary can obtain the API key directly from these providers on your behalf— no back-and-forth required. There’s no need for you to request the key yourself or forward it to Donary. We handle the entire process for you.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.donary.com/cloud-drm/getting-started/setup-and-configuration/api-keys/setting-up-api-keys.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.