GoDialPay Logo GoDialPay
Login Get API Keys
REST API VERSION 1.4.0

Developer API &
Integration Reference

Complete reference for integrating payment charges, instant virtual card issuance, USDT settlement triggers, and server-to-server webhook verification.

Authentication

Authenticate requests by including your secret API key in the request Authorization header. Keep your keys secret and never commit them into client-side code.

HTTP Header Format cURL 
Authorization: Bearer godial_live_sec_9942a1b7e409
POST /api/v1/charges/create

Initializes a secure checkout session or direct API charge for card & crypto payments with instant USDT routing.

JSON Payload POST Request 
{
  "amount": 75.00,
  "currency": "USD",
  "settlement_rail": "USDT_TRC20",
  "order_id": "ORD_99218A",
  "customer": {
    "email": "customer@example.com",
    "full_name": "John Doe"
  },
  "redirect_url": "https://yourdomain.com/payment-success"
}
GET /api/v1/charges/verify/{charge_id}

Retrieves current real-time transaction state, 3D Secure status, and corresponding on-chain settlement TXID.

Response Format JSON 200 OK 
{
  "status": "success",
  "charge_id": "ch_88291a0b",
  "paid_amount": 75.00,
  "settled_usdt": 75.00,
  "txid": "9c01f82b71a...442a"
}
POST /api/v1/cards/issue

Instantly mints a new virtual Visa card with clean BIN assignment and immediate balance allocation.

JSON Payload POST Request 
{
  "card_tier": "PRO_MEDIA",
  "initial_deposit": 50.00,
  "cardholder_name": "MARKETING ENTERPRISE LTD",
  "auto_topup": true
}

Standard Error Codes

GoDialPay returns standard HTTP status codes alongside descriptive error schemas:

Error Schema HTTP 400/401/429 
{
  "error": {
    "code": "card_declined",
    "message": "The transaction was declined due to 3DS verification timeout."
  }
}