Skip to main content
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

X-Auth-Token
string
required
Authentication token obtained after login.
uuid
string
required
Device UUID used for request tracking.
platform
string
required
Platform identifier (e.g., “WEB”, “ANDROID”, “IOS”).

Request Body

currencyiso3a
string
required
3-letter ISO currency code of the transaction (e.g., “USD”, “NGN”).
pan
string
required
Primary Account Number (card number) of the customer.
expirydate
string
required
Card expiry date in MM/yyyy format.
securitycode
string
required
Card CVV/security code.
requesttypedescriptions
string
required
Description of the request type (e.g., “purchase”, “refund”).
baseamount
string
required
Amount to charge the card.
pcn
string
Optional payment code number associated with the transaction.

Code Examples

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"
  }'