> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fincode.technology/llms.txt
> Use this file to discover all available pages before exploring further.

# Process Card Payment

> Process a card payment by providing card details, transaction amount, and request type. Returns the payment gateway response.

This endpoint allows a customer to **process a payment via card** by providing necessary card details.

Supported payment flows include:

* Authorizing a **card payment**
* Returning detailed **transaction response** including status, issuer info, and merchant details

## Authentication

<ParamField header="X-Auth-Token" type="string" required>
  Authentication token obtained after login.
</ParamField>

<ParamField header="uuid" type="string" required>
  Device UUID used for request tracking.
</ParamField>

<ParamField header="platform" type="string" required>
  Platform identifier (e.g., "WEB", "ANDROID", "IOS").
</ParamField>

## Request Body

<ParamField body="currencyiso3a" type="string" required>
  3-letter ISO currency code of the transaction (e.g., "USD", "NGN").
</ParamField>

<ParamField body="pan" type="string" required>
  Primary Account Number (card number) of the customer.
</ParamField>

<ParamField body="expirydate" type="string" required>
  Card expiry date in `MM/yyyy` format.
</ParamField>

<ParamField body="securitycode" type="string" required>
  Card CVV/security code.
</ParamField>

<ParamField body="requesttypedescriptions" type="string" required>
  Description of the request type (e.g., "purchase", "refund").
</ParamField>

<ParamField body="baseamount" type="string" required>
  Amount to charge the card.
</ParamField>

<ParamField body="pcn" type="string">
  Optional payment code number associated with the transaction.
</ParamField>

## Code Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl --request POST \
    --url "https://remitjunction.fincode.software/api/v6/services/paymentmanagement/process-card-payment" \
    --header 'Content-Type: application/json' \
    --header 'X-Auth-Token: your_auth_token' \
    --header 'uuid: your_device_uuid' \
    --header 'platform: WEB' \
    --data '{
      "currencyiso3a": "USD",
      "pan": "4111111111111111",
      "expirydate": "12/2025",
      "securitycode": "123",
      "requesttypedescriptions": "purchase",
      "baseamount": "150.00",
      "pcn": "PCN12345"
    }'
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    "https://remitjunction.fincode.software/api/v6/services/paymentmanagement/process-card-payment",
    {
      method: "POST",
      headers: {
        "Content-Type": "application/json",
        "X-Auth-Token": authToken,
        "uuid": deviceUuid,
        "platform": "WEB"
      },
      body: JSON.stringify({
        currencyiso3a: "USD",
        pan: "4111111111111111",
        expirydate: "12/2025",
        securitycode: "123",
        requesttypedescriptions: "purchase",
        baseamount: "150.00",
        pcn: "PCN12345"
      })
    }
  );

  const data = await response.json();
  ```

  ```python Python theme={null}
  import requests

  url = "https://remitjunction.fincode.software/api/v6/services/paymentmanagement/process-card-payment"
  headers = {
      "Content-Type": "application/json",
      "X-Auth-Token": "your_auth_token",
      "uuid": "your_device_uuid",
      "platform": "WEB"
  }
  payload = {
      "currencyiso3a": "USD",
      "pan": "4111111111111111",
      "expirydate": "12/2025",
      "securitycode": "123",
      "requesttypedescriptions": "purchase",
      "baseamount": "150.00",
      "pcn": "PCN12345"
  }

  response = requests.post(url, json=payload, headers=headers)
  data = response.json()
  ```
</CodeGroup>