Authipay
Quick Start
- Sign up at authipay.com and obtain API credentials
- Create a terminal in the Admin Console with the parameters below
- Start processing — the adapter is pre-built and ready to use
Overview
Authipay (Worldpay) — Payments (payment processor)
| Provider ID | authipay |
| Category | Card Processors |
| Website | authipay.com |
Supported operations: Sale (payments_authorize - one_phase) PreAuth (payments_authorize - two_phase verify) Capture (payments_capture - two_phase commit) Status (payments_status) Refund (payments_refund)
Authentication
Method: HMAC-SHA256 Signature
Algorithm:
Step 1: Signature String
signature_string = api_key + client_request_id + timestamp + payload_json
Step 2: HMAC SHA-256
signature = hex(hmac_sha256(signature_string, api_secret))
Step 3: Headers
API-KEY: {api_key}
Message-Signature: {signature}
Timestamp: {timestamp_ms}
Client-Request-Id: {uuid}
Auth-Token-Type: HMAC
Content-Type: application/json
Example generation:
import hmac
import hashlib
import time
import uuid
api_key = "api_abc123"
api_secret = "secret_xyz789"
client_request_id = str(uuid.uuid4())
timestamp = str(int(time.time() * 1000))
payload = '{"requestType":"PaymentCardSaleTransaction",...}'
signature_string = api_key + client_request_id + timestamp + payload
signature = hmac.new(
api_secret.encode(),
signature_string.encode(),
hashlib.sha256
).hexdigest()
Configuration
Required Parameters
| Parameter | Description |
|---|---|
base_url | Base API URL |
api_key | Public API Key |
api_secret | Secret key for HMAC |
Status Mapping
| Provider Status | 4pay Status | Description |
|---|---|---|
Successful transaction | Charged / Authorized | |
Error/decline | Failure | |
Processing | Pending |