# Credit Card Transactions

## Credit Cards

Starting with version 1.4, Kima supports credit card transactions in the origin network (onramping)- off ramping to come in a future release. See [Upgrading to v1.4.x](https://docs.kima.network/kima-network/the-kima-sdk/upgrading/v1.4) for more information on how to upgrade your integration.

Credit card transactions require the use of the [Kima Transaction Widget](https://docs.kima.network/kima-network/the-kima-sdk/add-kima-widget-to-your-app). This is a frontend React component which handles integration with Kima and 3rd party components which handle KYC and payment processing.

> ℹ️ Check the list of [unsupported Countries](https://docs.kima.network/kima-network/supported-fiat#unsupported-countries-credit-cards)

## Overview

The following steps outline the process of using the widget to buy stablecoins like USDC using a credit card.

1. From the "Source Network" dropdown, select "Credit Card"

<figure><img src="https://3134460121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJ6zSf6jJsAYmovV6Wkcr%2Fuploads%2Fgit-blob-6520d293981c49d61eb060489b5962629b849803%2Fcc_select.png?alt=media" alt=""><figcaption></figcaption></figure>

2. From the "Target Network" dropdown, select the desired chain and token- i.e. USDT on Arbitrum
3. Fill in the wallet address (Target Address) and amount, then click "Next"
4. Choose where the service fees will be paid from and click "Next". There are 2 options. The difference is where the service will be paid from.

* In the first option, the service fees are paid upfront on the credit card. Choose this option to receive the exact amount you specified in the "Amount" field.
* In the second option, the service fees are deducted from the amount you will receive. So you will get slightly less stablecoins the amount you specified in the "Amount" field.

<figure><img src="https://3134460121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJ6zSf6jJsAYmovV6Wkcr%2Fuploads%2Fgit-blob-6f51d4de60dee416758a15e8f7778305b4ac4d35%2Fcc_select_fee.png?alt=media" alt=""><figcaption></figcaption></figure>

5. When you have confirmed all details, click Next. This will load the credit card provider screen.

<figure><img src="https://3134460121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJ6zSf6jJsAYmovV6Wkcr%2Fuploads%2Fgit-blob-960aa3c4c6041a30bcb91c8754a17ffdc5811da7%2Fcc_widget_init.png?alt=media" alt=""><figcaption></figcaption></figure>

From here there are couple differences between the Testnet and Mainnet versions of the widget.

### Testnet Version

6. Please skip the KYC process by pressing the "Approve KYC" button. KYC will be required in the Mainnet version.

<figure><img src="https://3134460121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJ6zSf6jJsAYmovV6Wkcr%2Fuploads%2Fgit-blob-8f01dda32a7fea50e107b4c976a9b492d8749a87%2Fcc_testnet_skip_kyc.jpg?alt=media" alt=""><figcaption></figcaption></figure>

7. Select the payment method. For now, the only payment method available is Credit Card. For testnet, please use fake information excpet for the card number.

<figure><img src="https://3134460121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJ6zSf6jJsAYmovV6Wkcr%2Fuploads%2Fgit-blob-e91755b93a5a0ae977e32c1c5db8f0a78b33cbb7%2Fcc_testnet_fake_info.jpg?alt=media" alt=""><figcaption></figcaption></figure>

#### Testing Cards

```
Successful  
Visa: 4000000000002503
Mastercard: 5200000000002151

Failed  
Visa: 4000000000002420
Mastercard: 5200000000002664
```

* The expiration date must be in the future
* The CCV can be any number

### Mainnet Version

6. In order to send a transaction users will need to perform KYC. Select your country and complete all steps needed to reach the next screen and fill in your information and credit card details.

<figure><img src="https://3134460121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJ6zSf6jJsAYmovV6Wkcr%2Fuploads%2Fgit-blob-13e42427d35b4a2f464597b2b8f7e8107fe5b310%2Fcc_widget_kyc.png?alt=media" alt=""><figcaption></figcaption></figure>

Once you send all necessary data you'll need to wait a few minutes (or seconds) to proceed with the payment.

<figure><img src="https://3134460121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJ6zSf6jJsAYmovV6Wkcr%2Fuploads%2Fgit-blob-daa9fc7959254b12d32293c1931f49ace2afaea3%2Fcc_widget_kyc_processing.png?alt=media" alt=""><figcaption></figcaption></figure>

6. After the kyc process is complete, you'll be able to select your payment method. For now, the only available one is Credit Card:

<figure><img src="https://3134460121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJ6zSf6jJsAYmovV6Wkcr%2Fuploads%2Fgit-blob-e76998f60fdf73314d419fe6e7cdb4b7880ad609%2Fcc_widget_payment_select.png?alt=media" alt=""><figcaption></figcaption></figure>

In the next screen, fill in your card details and proceed with the payment:

<figure><img src="https://3134460121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJ6zSf6jJsAYmovV6Wkcr%2Fuploads%2Fgit-blob-3505aedc1bd2c3d56868e6721814ace25ccc0c5f%2Fcc_widget_card_details.png?alt=media" alt=""><figcaption></figcaption></figure>

If your transaction succeeds you will see the status screen, where you can track the current state of the transaction in the Kima blockchain.

<figure><img src="https://3134460121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJ6zSf6jJsAYmovV6Wkcr%2Fuploads%2Fgit-blob-98e19021cd5716f6a102947ece1022ea7bc905ff%2Fcc_payment_successful.png?alt=media" alt=""><figcaption></figcaption></figure>

If your payment is not sucessful, you will see a notification with a transaction id and asking you to contact support. Plese copy the transaction id and create a support ticket on the Kima Discord.

<figure><img src="https://3134460121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJ6zSf6jJsAYmovV6Wkcr%2Fuploads%2Fgit-blob-064261047e6ecfaa70e042312d36d7acfd095ac3%2Fcc_payment_unsuccessful.png?alt=media" alt=""><figcaption></figcaption></figure>
