Process with Card Token

Process a payment using a saved card token and encrypted CVV.

Endpoint Information

Name: Hosted Fields Process Transaction with Card Token
Method: POST
URL: {{BASE_URL}}/api/v1/payment/hf-process-transaction

Description

Process a payment for a returning customer using their saved cardToken. You must still collect the secret (CVV) via Hosted Fields encryption for security.

Authentication

Type: Basic Auth

• Username: App Key
• Password: Secret Key

Request Body

Content-Type: application/json

{
  "merchantAccountId": "{{yourMerchantAccountId}}",
  "customerToken": "73024c3fd651fea6a5ee404fe49bd0dc",
  "cardToken": "6d044049-5c2f-4b25-8eb3-6e1ad20e4578",
  "secret": "TzVaa5uSeHNggUJk7Rju6IPM7D1eS7CXwS0TFBgio... (encrypted string)",
  "customerBrowserUserAgent": "Mozilla/5.0...",
  "customerIP": "92.251.41.84",
  "currency": "EUR",
  "amount": 56,
  "is_hosted_fields_encrypted": true
}

Key Parameters

Parameter	Type	Required	Description
cardToken	string	Yes	The saved card token
secret	string	Yes	Encrypted CVV/CVC
is_hosted_fields_encrypted	boolean	Yes	Must be true

Response

Success Response

{
  "success": true,
  "message": "Payment processed successfully",
  "data": {
    "reference": "62617-5378",
    "status": "Accepted",
    "transactionId": "txn_abc123xyz"
  }
}