Response Handling
Handle API responses, errors, and payment outcomes
Response Handling
Learn how to handle API responses and payment outcomes in your integration.
Response types
HTTP Status Codes
Standard HTTP response codes from the API
Error Codes
API error types and how to handle them
Refusal Reasons
Payment decline reasons and customer messaging
Response structure
Successful response
{
"id": "pay_abc123",
"object": "payment",
"amount": 5000,
"currency": "USD",
"status": "succeeded",
"created": 1679529600
}Error response
{
"error": {
"type": "invalid_request_error",
"code": "parameter_missing",
"message": "Missing required parameter: amount",
"param": "amount",
"request_id": "req_xyz789"
}
}Best practices
- Check HTTP status first - 2xx means success, 4xx/5xx means error
- Parse error objects - Extract type, code, and message
- Log request IDs - Include in support requests
- Handle idempotency - Use idempotency keys for retries
- Display user-friendly messages - Don't show raw errors to customers