Process Card Payment

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

string

required

Authentication token obtained after login.

string

required

Device UUID used for request tracking.

string

required

Platform identifier (e.g., “WEB”, “ANDROID”, “IOS”).

Request Body

string

required

3-letter ISO currency code of the transaction (e.g., “USD”, “NGN”).

string

required

Primary Account Number (card number) of the customer.

string

required

Card expiry date in MM/yyyy format.

string

required

Card CVV/security code.

string

required

Description of the request type (e.g., “purchase”, “refund”).

string

required

Amount to charge the card.

string

Optional payment code number associated with the transaction.

Code Examples

curl --request POST \
  --url "https://{your-domain}.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"
  }'

const response = await fetch(
  "https://{your-domain}.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();

import requests

url = "https://{your-domain}.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()

Getting Started

Core Flows

API Endpoints

Authentication

Request Body

Code Examples

​Authentication

​Request Body

​Code Examples

Authentication

Request Body

Code Examples