Home Developers API ReferenceSimple Payment Gateway (S2S)

Simple Payment Gateway (S2S)

Quick backend integration — POST JSON directly over HTTPS.

POSThttp://localhost:9003/api/s2s

Payment online from customers

Remark: 11 mandatory parameters, others optional

Request (JSON)

POST /api/s2s

{
  "reference": "1DEVJAVA250422",
  "public_key": "WO6QnIPePdYlwbm6OjpIIwQvhsHaV4ioHp6MH2/xjlQ=",
  "bill_amt": "11.11",
  "bill_currency": "EUR",
  "bill_address": "3888 Austin Secret Lane",
  "bill_city": "Circleville 22",
  "bill_country": "US",
  "bill_email": "devops@text.com",
  "bill_ip": "222.176.92.333",
  "bill_phone": "65 62294466",
  "bill_state": "Utah",
  "bill_zip": "84723",
  "fullname": "Testing Dev Tech",
  "integration-type": "s2s",
  "mop": "CC",
  "product_name": "Testing DEV Product",
  "return_url": "https://www.google.com/",
  "source": "server-to-server integration",
  "source_url": "http://your.domain/source-url",
  "terNO": 42,
  "webhook_url": "https://webhook.site/your-webhook-id",
  "ccno": "4111111111111111",
  "ccvv": "123",
  "month": "01",
  "year": "30"
}

Response

200 OK

{
  "authstatus": "http://localhost:9003/api/authurl/s2s/100135250426141606",
  "bill_currency": "EUR",
  "transID": "100135250426141606",
  "mop": "Mastercard",
  "ccno": "543889XXXXXX0229",
  "reference": "22DEVJAVA250415",
  "authurl": "http://localhost:9003/api/authurl/100135250426141606",
  "order_status": "0",
  "tdate": "2025-04-26 14:16:06.000657",
  "response": "Payment is pending",
  "authdata": "eyJ0cmFuc0lEIjoxMDAxMzUy...",
  "bill_amt": "120.0",
  "status": "Pending"
}

Redirect the customer to authurl for 3DS OTP authentication. Final status arrives via webhook_url.

API Parameters

M = Merchant (required) · D = Default (fixed) · C = Customer (optional)

Parameter	Type	Description
public_key	str M	Terminal public key from My Terminal → Terminal Public Key.
terNO	int M	Unique terminal number from My Terminal → Add New Terminal List.
integration-type	str D	Default fixed value: s2s.
bill_amt	dec(10,2) M	Bill amount in decimal format (e.g. 120.00).
bill_currency	str M	ISO currency code (e.g. EUR, USD).
product_name	str M	Product or service name.
reference	str M	Your unique order ID — returned in callbacks.
webhook_url	str M	Server-to-server webhook URL for status updates.
return_url	str M	Customer redirect URL after authentication.
bill_ip	server D	Customer IP — set server-side from REMOTE_ADDR.
fullname	str C	Customer full name (optional).
bill_email	str C	Customer billing email (optional).
mop	str M	Payment mode: CC, DC, NB, WALLET, UPICOLLECT, QRINTENT.
ccno	str C	Card number (required for mop=CC).
ccvv	str C	Card CVV (required for mop=CC).
month	str C	Card expiry month (required for mop=CC).
year	str C	Card expiry year (required for mop=CC).