# Card-to-Crypto Fiat Onramp

<figure><img src="https://content.gitbook.com/content/wm1DIvbGMREWT1TdLPtz/blobs/I9VWk5HiMmE1j8LLIacH/payram-card-to-crypto-fiat-onramp.png" alt=""><figcaption></figcaption></figure>

Card-to-Crypto Onramp or Fiat Onramp allows merchants to accept customer payments in fiat currency while receiving settlements in crypto through PayRam. It removes the need for external exchanges or manual conversions, letting businesses expand their customer base and simplify checkout experiences.

***

### Why it Matters

* Lets merchants reach customers who prefer paying in fiat.
* Enables seamless acceptance of cards, wallets, bank transfer, and local payment methods.
* Automatically settles payments in crypto, keeps all settlements non-custodial.
* Reduces conversion friction and simplifies operations.

***

### PayRam Wallets App

This method allows merchants to accept fiat payments, including card, bank transfer, and more, through PayRam's integrated, self-custody wallet layer, offering a faster setup and a smoother customer experience.&#x20;

Onramp transactions are powered by regulated, third-party fiat-to-crypto providers, with Card-to-Crypto payments now supported via the PayRam Wallet App.

#### How it works for merchants:

* Merchants do not need to complete KYC/KYB to enable this Onramp method.
* Activation is available directly inside the PayRam Dashboard. Activate Card-to-Crypto onramp in seconds!
* Merchants will have the option to sponsor gas fees for customers, reducing friction and improving conversion.

#### How it works for customers:

* A self-custodial PayRam Wallet is automatically generated for the customers, which they can also use for storing, managing, and transferring their digital assets.
* Customers will still be required to complete a basic one-time KYC verification in their first purchase.
* After verification, customers can pay using a card or other supported fiat methods with minimal steps.

#### Commercials and fees:

* PayRam does not apply any additional fees or markups on onramp transactions.
* All onramp related commercials are directly applied by the third-party onramp partners.

#### Checkout experience:

* Onramp transaction funds are deposited directly into the customer's self-custodial PayRam Wallet, after which the customer can use the funds to complete the transaction with the merchant.

#### Supported payment methods:

Customers have access to 175+ payment methods across 190+ countries, with smart routing that matches each user to the best available option based on their region, amount, and payment preference.

Based on their geographic location, customers can complete payments in:&#x20;

* Credit and Debit Card
* Apple Pay
* Google Pay
* Bank Transfer (ACH, SEPA, and local equivalents)
* RevolutPay

***

## How to Enable Card-to-Crypto Onramp via PayRam Wallet

{% hint style="info" %}
**Keep Your Instance Up to Date**

Make sure your PayRam instance is running the latest version before proceeding. You can update it at any time using the update script. See [Script Usage: Update](https://docs.payram.com/script/script-usage#update) for further instructions.
{% endhint %}

{% hint style="info" %}
**Card Payments Require the Base Blockchain**

Card payments and other fiat payment options are currently supported on the Base blockchain only. Before accepting payments via cards, ensure that the Base blockchain is enabled in your PayRam settings.
{% endhint %}

{% stepper %}
{% step %}

### Navigate to Settings

* Log in to your PayRam Dashboard and go to the Settings section.

<figure><img src="https://content.gitbook.com/content/wm1DIvbGMREWT1TdLPtz/blobs/jVfTMLGx91XZAjvY9LKf/image.png" alt=""><figcaption></figcaption></figure>

* Now click on the Payment Channels option.

<figure><img src="https://content.gitbook.com/content/wm1DIvbGMREWT1TdLPtz/blobs/huTf9T1A80AP58ODUDcr/image.png" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Activate Cards

* Click on the Activate button beside **Cards** to access the pop-up with more details.

<figure><img src="https://content.gitbook.com/content/wm1DIvbGMREWT1TdLPtz/blobs/ChkUaFH52mrLKIOkmuDC/image.png" alt=""><figcaption></figcaption></figure>

* In the pop-up, you'll have to click on Activate to instantly enable the payment method.&#x20;

<figure><img src="https://content.gitbook.com/content/wm1DIvbGMREWT1TdLPtz/blobs/H6cMZFre5wNvAPy780cu/image.png" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Card Payments Require the Base Blockchain**

Card payments and other fiat payment options are currently supported on the Base blockchain only. Before accepting payments via cards, ensure that the Base blockchain is enabled in your PayRam settings.
{% endhint %}
{% endstep %}

{% step %}

### Accept payments

* Go to the Payments menu in the sidebar, click the dropdown, and then select Create Payment Link.
* Create a payment link by entering the customer’s email and the required amount, then click Generate Payment Link.

<figure><img src="https://content.gitbook.com/content/wm1DIvbGMREWT1TdLPtz/blobs/JnWowFUKwezURw6lycDH/image.png" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Pay using PayRam Wallet

* Your customers will now see the Card payment option on the payment page. They just need to click on Cards to use it.

<figure><img src="https://content.gitbook.com/content/wm1DIvbGMREWT1TdLPtz/blobs/mhTwXU5OzMPgwy8IzSF0/image.png" alt=""><figcaption></figcaption></figure>

* Customers will have to first setup their self-custody PayRam Wallet. They can use their email address to quickly create one in a few seconds.

<figure><img src="https://content.gitbook.com/content/wm1DIvbGMREWT1TdLPtz/blobs/3QIfsfn0g3ohFA3sTIkw/image.png" alt=""><figcaption></figcaption></figure>

* They will be prompted to Add Funds equivalent to the transaction amount.

<figure><img src="https://content.gitbook.com/content/wm1DIvbGMREWT1TdLPtz/blobs/d2T4nHRkfsRPjhfJQipd/image.png" alt=""><figcaption></figcaption></figure>

* They can pay using their credit/debit cards or banks or other supported payment methods through the onramp widget, and the crypto will be deposited directly into the customer’s self-custody wallet.

<figure><img src="https://content.gitbook.com/content/wm1DIvbGMREWT1TdLPtz/blobs/U6Q8rHRPwCKbddpzsf6k/image.png" alt=""><figcaption></figcaption></figure>

* They can then use the deposited funds to complete the transaction.

<figure><img src="https://content.gitbook.com/content/wm1DIvbGMREWT1TdLPtz/blobs/bd7AqQEF710FCMzBjal7/image.png" alt=""><figcaption></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/wm1DIvbGMREWT1TdLPtz/blobs/9DnQvoVMD6tmQZgWEDCP/image.png" alt=""><figcaption></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/wm1DIvbGMREWT1TdLPtz/blobs/RQxmgy3Rjltx0xkQ4YjL/image.png" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

## Managing Card-to-Crypto Onramp Access for Individual Projects

If you run multiple projects under a single PayRam account, you can control Card-to-Crypto onramp access at the project level. This allows you to enable or disable onramp independently for each project after activating the onramp API.

### How Project-Level Card-to-Crypto Onramp Management Works

Once the Onramp API is activated:

* Onramp is **enabled by default for all projects**
* You must manually disable it for any project where you do not want to offer onramp

### Steps to Enable or Disable Onramp for a Project

{% stepper %}
{% step %}

### Navigate To Settings

Go to Settings and select Account

<figure><img src="https://content.gitbook.com/content/wm1DIvbGMREWT1TdLPtz/blobs/Vrwtso65PeHceJ7AFfM7/image.png" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Choose Project

Choose the Project you want to manage
{% endstep %}

{% step %}

<figure><img src="https://content.gitbook.com/content/wm1DIvbGMREWT1TdLPtz/blobs/u8iFHtiJfVHRuJfD2ay0/image.png" alt=""><figcaption></figcaption></figure>

### Payment Options

Open the Payment Options tab
{% endstep %}

{% step %}

<figure><img src="https://content.gitbook.com/content/wm1DIvbGMREWT1TdLPtz/blobs/SPJbTkqnomEdM17ad9dj/image.png" alt=""><figcaption></figcaption></figure>

### Activate or Deactivate Cards

Toggle Cards on or off for that project

<figure><img src="https://content.gitbook.com/content/wm1DIvbGMREWT1TdLPtz/blobs/okK4y6NCpzLduxYk5390/image.png" alt=""><figcaption></figcaption></figure>

Your changes apply immediately to the selected project.
{% endstep %}
{% endstepper %}
