Introduction

Welcome to the Paychtec API documentation. Learn how to process payments and manage your financial operations through our secure infrastructure.

About the platform

Paychtec is a full-stack payment processor that allows you to accept, process, and manage payments globally through a single unified API. Leverage our robust infrastructure to handle payments, refunds, disputes, and complete financial reporting with a single integration.

Base URL

All API requests should be made to the following base URL:

https://api.v2.paychtec.com

Important: Use Sandbox for Testing! Do not use production credentials during development or testing. Always use the sandbox endpoint https://api.sandbox.paychtec.com with your sandbox API keys (prefixed with snd_). Using production credentials for testing will result in real charges to customers.

Sandbox Environment: For testing, use https://api.sandbox.paychtec.com with your test API keys.

Quick Start

Here's a quick example of how to create a payment:

curl -X POST 'https://api.v2.paychtec.com/payments' \
  -H "Content-Type: application/json" \
  -H "api-key: YOUR_API_KEY" \
  -d '{
"amount": 1000,
"currency": "USD",
"profile_id": "YOUR_PROFILE_ID",
"customer_id": "YOUR_CUSTOMER_ID",
"description": "Order payment",
"capture_method": "automatic",
"email": "guest@example.com",
"authentication_type": "three_ds",
"confirm": true,
"payment_method": "card",
"payment_method_data": {
  "card": {
    "card_number": "4242424242424242",
    "card_exp_month": "12",
    "card_exp_year": "2028",
    "card_cvc": "123"
  }
},
"billing": {
  "address": {
    "line1": "1600",
    "line2": "Amphitheatre Parkway",
    "city": "Mountain View",
    "state": "California",
    "zip": "94043",
    "country": "US",
    "first_name": "John",
    "last_name": "Doe"
  },
  "phone": {
    "number": "6502530000",
    "country_code": "+1"
  }
}
}'

curl -X POST 'https://api.v2.paychtec.com/payments' \  -H "Content-Type: application/json" \  -H "api-key: YOUR_API_KEY" \  -d '{"amount": 1000,"currency": "USD","profile_id": "YOUR_PROFILE_ID","customer_id": "YOUR_CUSTOMER_ID","description": "Order payment","capture_method": "automatic","email": "guest@example.com","authentication_type": "three_ds","confirm": true,"payment_method": "card","payment_method_data": {  "card": {    "card_number": "4242424242424242",    "card_exp_month": "12",    "card_exp_year": "2028",    "card_cvc": "123"  }},"billing": {  "address": {    "line1": "1600",    "line2": "Amphitheatre Parkway",    "city": "Mountain View",    "state": "California",    "zip": "94043",    "country": "US",    "first_name": "John",    "last_name": "Doe"  },  "phone": {    "number": "6502530000",    "country_code": "+1"  }}}'

Authentication

All API endpoints require authentication using an API key. Include your API key in the request headers:

api-key: YOUR_API_KEY

Keep your API key secure. Never expose your API key in client-side code or public repositories. Always make API calls from your server.

Response Format

All responses are returned in JSON format. Successful responses will include the requested data, while errors will include an error code and message.

{
  "payment_id": "pay_1234567890",
  "status": "succeeded",
  "amount": 1000,
  "currency": "USD",
  "created": "2024-01-15T10:30:00Z"
}

Next Steps

Authentication — Learn how to authenticate your API requests
Create Payment — Process your first payment
Quickstart — Process your first payment in 5 minutes
Error Handling — Handle errors gracefully