Retrieve a checkout
curl --request GET \
--url https://api.pay.flipeet.io/api/v1/transaction \
--header 'x-api-key: <api-key>'const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.pay.flipeet.io/api/v1/transaction', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.pay.flipeet.io/api/v1/transaction"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"message": "Transaction retrieved successfully.",
"status": "success",
"statusCode": 200,
"data": {
"id": "2b7c4e1a-9d3f-4a6b-8c2e-5f1d0a9b8c7d",
"amount": 25000,
"asset": "usdc",
"checkoutUrl": "https://pay.flipeet.io/checkout?ref=fp_8f2k3m&theme=light",
"currency": "NGN",
"memo": "Order #1042",
"merchantName": "Ada Stores",
"merchantLogo": null,
"network": "base",
"payer": "0x5aE1c3B0d2F4e6A8b0C2d4E6f8A0b2C4d6E89c21",
"payableAmount": 16.67,
"payerEmail": "ada@example.com",
"paymentDate": "2026-11-04T10:21:09.000Z",
"paymentAddress": "0x8b3F5a7C9e1B3d5F7a9C1e3B5d7F9a1C3e5B02aD",
"reference": "order_1042",
"feeAmount": 125,
"feePercentage": 0.5,
"txRef": "fp_8f2k3m",
"txHash": "0x4f9e2a6c8e0b2d4f6a8c0e2b4d6f8a0c2e4b6d8f0a2c4e6b8d0f2a4c6e8bb7c1",
"theme": "light",
"redirectUrl": "https://shop.example.com/thanks",
"status": "completed",
"mode": "live",
"livemode": true,
"createdAt": "2026-11-04T10:21:09.000Z"
}
}{
"message": "Amount must be a positive number",
"status": "error",
"statusCode": 400,
"code": "invalid_request",
"details": {
"errors": [
"Amount must be a positive number"
]
},
"requestId": "req_5f0c2a9b8d7e4c1f9a3b6d2e1c0f7a8b",
"timestamp": "2026-11-04T10:00:00.000Z"
}{
"message": "Invalid or inactive API key",
"status": "error",
"statusCode": 401,
"code": "authentication_failed",
"details": null,
"requestId": "req_5f0c2a9b8d7e4c1f9a3b6d2e1c0f7a8b",
"timestamp": "2026-11-04T10:00:00.000Z"
}{
"message": "Transaction not found",
"status": "error",
"statusCode": 404,
"code": "not_found",
"details": null,
"requestId": "req_5f0c2a9b8d7e4c1f9a3b6d2e1c0f7a8b",
"timestamp": "2026-11-04T10:00:00.000Z"
}{
"message": "Too many requests. Slow down and try again shortly.",
"status": "error",
"statusCode": 429,
"code": "rate_limited",
"details": null,
"requestId": "req_5f0c2a9b8d7e4c1f9a3b6d2e1c0f7a8b",
"timestamp": "2026-11-04T10:00:00.000Z"
}{
"message": "Internal server error",
"status": "error",
"statusCode": 500,
"code": "internal_error",
"details": null,
"requestId": "req_5f0c2a9b8d7e4c1f9a3b6d2e1c0f7a8b",
"timestamp": "2026-11-04T10:00:00.000Z"
}Checkout
Retrieve a checkout
Looks up one of your checkouts by the txRef returned when you created it. Use it to confirm a payment if you missed its webhook.
GET
/
api
/
v1
/
transaction
Retrieve a checkout
curl --request GET \
--url https://api.pay.flipeet.io/api/v1/transaction \
--header 'x-api-key: <api-key>'const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.pay.flipeet.io/api/v1/transaction', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.pay.flipeet.io/api/v1/transaction"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"message": "Transaction retrieved successfully.",
"status": "success",
"statusCode": 200,
"data": {
"id": "2b7c4e1a-9d3f-4a6b-8c2e-5f1d0a9b8c7d",
"amount": 25000,
"asset": "usdc",
"checkoutUrl": "https://pay.flipeet.io/checkout?ref=fp_8f2k3m&theme=light",
"currency": "NGN",
"memo": "Order #1042",
"merchantName": "Ada Stores",
"merchantLogo": null,
"network": "base",
"payer": "0x5aE1c3B0d2F4e6A8b0C2d4E6f8A0b2C4d6E89c21",
"payableAmount": 16.67,
"payerEmail": "ada@example.com",
"paymentDate": "2026-11-04T10:21:09.000Z",
"paymentAddress": "0x8b3F5a7C9e1B3d5F7a9C1e3B5d7F9a1C3e5B02aD",
"reference": "order_1042",
"feeAmount": 125,
"feePercentage": 0.5,
"txRef": "fp_8f2k3m",
"txHash": "0x4f9e2a6c8e0b2d4f6a8c0e2b4d6f8a0c2e4b6d8f0a2c4e6b8d0f2a4c6e8bb7c1",
"theme": "light",
"redirectUrl": "https://shop.example.com/thanks",
"status": "completed",
"mode": "live",
"livemode": true,
"createdAt": "2026-11-04T10:21:09.000Z"
}
}{
"message": "Amount must be a positive number",
"status": "error",
"statusCode": 400,
"code": "invalid_request",
"details": {
"errors": [
"Amount must be a positive number"
]
},
"requestId": "req_5f0c2a9b8d7e4c1f9a3b6d2e1c0f7a8b",
"timestamp": "2026-11-04T10:00:00.000Z"
}{
"message": "Invalid or inactive API key",
"status": "error",
"statusCode": 401,
"code": "authentication_failed",
"details": null,
"requestId": "req_5f0c2a9b8d7e4c1f9a3b6d2e1c0f7a8b",
"timestamp": "2026-11-04T10:00:00.000Z"
}{
"message": "Transaction not found",
"status": "error",
"statusCode": 404,
"code": "not_found",
"details": null,
"requestId": "req_5f0c2a9b8d7e4c1f9a3b6d2e1c0f7a8b",
"timestamp": "2026-11-04T10:00:00.000Z"
}{
"message": "Too many requests. Slow down and try again shortly.",
"status": "error",
"statusCode": 429,
"code": "rate_limited",
"details": null,
"requestId": "req_5f0c2a9b8d7e4c1f9a3b6d2e1c0f7a8b",
"timestamp": "2026-11-04T10:00:00.000Z"
}{
"message": "Internal server error",
"status": "error",
"statusCode": 500,
"code": "internal_error",
"details": null,
"requestId": "req_5f0c2a9b8d7e4c1f9a3b6d2e1c0f7a8b",
"timestamp": "2026-11-04T10:00:00.000Z"
}