API Documentation - Instant Transaction

Getting Started

The Instant Transaction API is a RESTful API that allows you to process payments, manage customers, and handle transactions programmatically. Our API uses JSON for request and response bodies and standard HTTP methods.

Base URL

https://api.instant-transaction.digital/v1

Authentication

All API requests require authentication using your API key. Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Endpoints

POST /charges

Create a new charge (process a payment)

Request Body

{
  "amount": 100.00,
  "currency": "usd",
  "source": "tok_visa",
  "description": "Payment for Order #1234",
  "metadata": {
    "order_id": "1234",
    "customer_id": "5678"
  }
}
        

Response

{
  "id": "ch_1234567890",
  "object": "charge",
  "amount": 10000,
  "currency": "usd",
  "status": "succeeded",
  "created": 1640995200,
  "receipt_url": "https://pay.instant-transaction.digital/receipts/ch_1234567890"
}
        

GET /charges/{charge_id}

Retrieve a specific charge

POST /refunds

Create a refund for a charge

POST /customers

Create a new customer

GET /customers/{customer_id}

Retrieve a customer

SDKs and Libraries

We offer official SDKs for popular programming languages:

PHP: composer require instant-transaction/sdk
Node.js: npm install @instant-transaction/sdk
Python: pip install instant-transaction
Ruby: gem install instant_transaction

Error Handling

The API uses standard HTTP response codes:

200: Success
400: Bad Request
401: Unauthorized
404: Not Found
500: Server Error

Webhooks

Configure webhooks to receive real-time notifications about events in your account. Supported events include:

charge.succeeded - Payment completed successfully
charge.failed - Payment failed
charge.refunded - Payment was refunded
chargeback.created - A chargeback was initiated

Testing

Use our sandbox environment for testing:

Base URL: https://sandbox-api.instant-transaction.digital/v1

Test Card Numbers:
- Visa: 4242 4242 4242 4242
- Mastercard: 5555 5555 5555 4444
- Amex: 3782 822463 10005
        

Support

For API support, contact us at support@instant-transaction.digital