Process with Encrypted Data

Process a payment using fully encrypted payment data.

Endpoint Information

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

Description

Process a transaction where all sensitive card data (number, name, expiry, secret) is encrypted on the client side before being sent to your server. This ensures that your server never handles plain-text card data.

Authentication

Type: Basic Auth

• Username: App Key
• Password: Secret Key

Request Body

Content-Type: application/json

{
  "merchantAccountId": "100643",
  "amount": "1000",
  "currency": "EUR",
  "card_name": "gcBqQaEykuq... (encrypted)",
  "card": "MhQnymw22Qo... (encrypted)",
  "expiry_date": "QKDjud9HT3t... (encrypted)",
  "secret": "hJttJGsNkYQ... (encrypted)",
  "is_hosted_fields_encrypted": true
}

Key Parameters

Parameter	Type	Required	Description
card	string	Yes	Encrypted card number
card_name	string	Yes	Encrypted cardholder name
expiry_date	string	Yes	Encrypted expiry date
secret	string	Yes	Encrypted CVV
is_hosted_fields_encrypted	boolean	Yes	Must be true

Response

Success Response

{
  "success": true,
  "message": "Payment processed successfully",
  "data": {
    "reference": "auto_generated_ref_123",
    "status": "Accepted",
    "transactionId": "txn_encrypted_789xyz"
  }
}