Country:
/v1/payments
Create Payment
Process a new payment transaction
Basic card payment processing
amount
Payment amount in cents
example
currency
Three-letter currency code
example
card_number
Credit card number
example
cvv
Card verification value
example
expiry_month
Card expiry month (MM)
example
expiry_year
Card expiry year (YYYY)
example
customer_id
Customer identifier
example
description
Payment description
example
Request Example
{
"amount": 1500,
"currency": "USD",
"card_number": "4111111111111111",
"cvv": "123",
"expiry_month": "12",
"expiry_year": "2025",
"customer_id": "cust_123456",
"description": "Order #12345"
}Response Examples
200
Payment created successfully
{
"id": "pay_1234567890",
"status": "succeeded",
"amount": 1500,
"currency": "USD",
"card": {
"last4": "1111",
"brand": "visa",
"exp_month": 12,
"exp_year": 2025
},
"customer_id": "cust_123456",
"description": "Order #12345",
"created": 1647875400,
"processing_fee": 45
}400
Invalid request parameters
{
"error": {
"type": "invalid_request_error",
"code": "parameter_invalid",
"message": "Invalid card number provided",
"param": "card_number"
}
}402
Payment failed
{
"error": {
"type": "card_error",
"code": "card_declined",
"message": "Your card was declined",
"decline_code": "insufficient_funds"
}
}500
Internal server error
{
"error": {
"type": "api_error",
"message": "An unexpected error occurred. Please try again later."
}
}Language
Login required to test API
Code Examples
cURL
curl -X POST "https://api.akua.la/v1/payments" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"amount": 1500,
"currency": "USD",
"card_number": "4111111111111111",
"cvv": "123",
"expiry_month": "12",
"expiry_year": "2025",
"customer_id": "cust_123456",
"description": "Order #12345"
}''