Card Payments

Card Payment Processor

post

This endpoint initiates a card payment transaction. Encrypted card_hash has the following JSON fields:

• card_type: Type of card (e.g., MASTER, VISA, etc.)
• cardname: Cardholder Name
• card_number: Card Digits
• card_cvv: Card CVV or CVV2
• expiry_month: Card Expiry Month
• expiry_year: Card Expiry Year
• token: Card token from previous transaction response (if provided, leave card details empty)

Card AES (CBC Mode) Encryption Formula: Base64Encode(AESEncrypt(card_json_data, 'secret', 'key')) (e.g., Output: NVlTU29VRUlPeUc2ZGc3cFlzTHpzb2hXZXN1U3RjYUlTd2w4cXhRMVkyWT0=)

Body

application/json

merchant_idstringOptional

Merchant platform no.

tranxRefstringOptional

Merchant transaction reference

amountnumber · decimalOptional

Transaction amount in decimal value (e.g: 5000.00)

currencystringOptional

Transaction currency example (e.g: GBP)

billing_countrystring · nullableOptional

Customer country ISO-2 code for new customer

billing_addressstring · nullableOptional

Customer address for new customer

billing_statestring · nullableOptional

Customer state for new customer

billing_citystring · nullableOptional

Customer city for new customer

billing_zipcodestring · nullableOptional

Customer zip code for new customer

redirect_urlstringOptional

Merchant platform redirect url after 3D authentication. is completed by the customer

ipstringOptional

Customer IP address, must be unique per customer transaction.

card_hashstringOptional

Encrypted customer card information.

customerone ofOptional

Customer Data

Responses

200

Response.

application/json

400Error

application/json

default

application/json

post

/api/v1/payment/card-processor

HTTPcURLJavaScriptPython

POST /api/v1/payment/card-processor HTTP/1.1
Host: gateway-core-test.plonictech.com
Content-Type: application/json
Accept: */*
Content-Length: 328

{
  "merchant_id": "text",
  "tranxRef": "text",
  "amount": 1,
  "currency": "text",
  "billing_country": "text",
  "billing_address": "text",
  "billing_state": "text",
  "billing_city": "text",
  "billing_zipcode": "text",
  "redirect_url": "text",
  "ip": "text",
  "card_hash": "text",
  "customer": {
    "email": "text",
    "phonenumber": "text",
    "firstname": "text",
    "lastname": "text"
  }
}

{
  "message_id": "text",
  "message": "text",
  "succeeded": true,
  "statuscode": 1,
  "data": {
    "transaction_id": "text",
    "merhc_tranxRef": "text",
    "transactionRef": "text",
    "amount": 1,
    "currency": "text",
    "ip": "text",
    "card_details": {
      "type": "text",
      "first6": "text",
      "last4": "text",
      "expYear": "text",
      "expMonth": "text",
      "cardName": "text",
      "token": "text"
    },
    "status": "text",
    "authorization_url": "text",
    "authorization_params": null,
    "authorization_method": "text",
    "transaction_date": "text"
  }
}

Transaction Status Query

get

This is the transaction status after processing:

Pending | Failed | Successful

Pending_Refund | Refunded | Chargeback

Pending_Cancel | Cancelled

Query parameters

MerchantRefstring · nullableOptional

Merchant Reference.

TransactionRefstring · nullableOptional

Transaction Reference.

Responses

200

Response.

application/json

400Error

application/json

default

application/json

get

/api/v1/payment/query-status

HTTPcURLJavaScriptPython

GET /api/v1/payment/query-status HTTP/1.1
Host: gateway-core-test.plonictech.com
Accept: */*

{
  "message_id": "text",
  "message": "text",
  "succeeded": true,
  "statuscode": 1,
  "data": {
    "transaction_id": "text",
    "merhc_tranxRef": "text",
    "platform_tranxRef": "text",
    "amount": 1,
    "currency": "text",
    "card_details": {
      "type": "text",
      "first6": "text",
      "last4": "text",
      "expYear": "text",
      "expMonth": "text",
      "cardName": "text",
      "token": "text"
    },
    "status": "text",
    "transaction_date": "text"
  }
}

Transaction Full Details

get

This endpoint fetch full transaction details with customer information

Path parameters

transactionidstring · guidRequired

Responses

200

Response.

application/json

400Error

application/json

default

application/json

get

/api/v1/payment/{transactionid}/details

HTTPcURLJavaScriptPython

GET /api/v1/payment/{transactionid}/details HTTP/1.1
Host: gateway-core-test.plonictech.com
Accept: */*

{
  "message_id": "text",
  "message": "text",
  "succeeded": true,
  "statuscode": 1,
  "data": {
    "transactionId": "text",
    "merchantID": "text",
    "merchantTranxRef": "text",
    "transactionRef": "text",
    "amount": 1,
    "currency": "text",
    "ip": "text",
    "cardDetails": {
      "type": "text",
      "first6": "text",
      "last4": "text",
      "expYear": "text",
      "expMonth": "text",
      "cardName": "text",
      "token": "text"
    },
    "status": "text",
    "transactionDate": "text",
    "deliveryDate": "text",
    "description": "text",
    "customerInfo": {
      "email": "text",
      "phonenumber": "text",
      "firstname": "text",
      "lastname": "text"
    }
  }
}

Search Transaction

get

Search transactions using available filters.

Body

application/json

and

Responses

200

Response.

application/json

400Error

application/json

default

application/json

get

/api/v1/payment/search

HTTPcURLJavaScriptPython

GET /api/v1/payment/search HTTP/1.1
Host: gateway-core-test.plonictech.com
Content-Type: application/json
Accept: */*
Content-Length: 105

{
  "pageNumber": 1,
  "pageSize": 1,
  "startDate": "2026-01-30T16:16:35.781Z",
  "endDate": "2026-01-30T16:16:35.781Z"
}

{
  "data": [
    {
      "transaction_id": "text",
      "merhc_tranxRef": "text",
      "transactionRef": "text",
      "amount": 1,
      "currency": "text",
      "card_details": {
        "type": "text",
        "first6": "text",
        "last4": "text",
        "expYear": "text",
        "expMonth": "text",
        "cardName": "text"
      },
      "status": "text",
      "transaction_date": "text"
    }
  ],
  "currentPage": 1,
  "totalPages": 1,
  "totalCount": 1,
  "pageSize": 1,
  "hasPreviousPage": true,
  "hasNextPage": true
}