Get Transaction Details

1 curl https://api.payos.money/v1/transactions/transactionId

1 { 2 "transactionId": "TXN_1234567890", 3 "status": "SETTLED", 4 "createdAt": [ 5 "2024-03-20T09:00:00Z" 6 ], 7 "checkoutSession": { 8 "sessionId": "SESSION_123", 9 "paymentLink": "https://payos.money/pay/SESSION_123" 10 }, 11 "paymentAttempts": [ 12 { 13 "status": "FAILED", 14 "createdAt": "2024-01-15T09:30:00Z", 15 "amount": { 16 "value": 10000, 17 "currency": "NGN" 18 }, 19 "id": "PAY_1234567890", 20 "processorId": "processorId", 21 "processorName": "Flutterwave", 22 "processorReference": "processorReference", 23 "processorConfigId": "processorConfigId", 24 "holderId": "holderId", 25 "workspaceId": "workspaceId", 26 "instrumentId": "instrumentId", 27 "paymentMethodType": "card present", 28 "metadata": { 29 "key": "value" 30 } 31 }, 32 { 33 "status": "COMPLETED", 34 "createdAt": "2024-01-15T09:30:00Z", 35 "amount": { 36 "value": 10000, 37 "currency": "NGN" 38 }, 39 "id": "PAY_0987654321", 40 "processorId": "processorId", 41 "processorName": "Paystack", 42 "processorReference": "processorReference", 43 "processorConfigId": "processorConfigId", 44 "holderId": "holderId", 45 "workspaceId": "workspaceId", 46 "instrumentId": "instrumentId", 47 "paymentMethodType": "card present", 48 "metadata": { 49 "key": "value" 50 } 51 } 52 ], 53 "refunds": [ 54 { 55 "refundId": "REF_123456", 56 "amount": { 57 "value": 2000, 58 "currency": "NGN" 59 }, 60 "status": "COMPLETED" 61 } 62 ], 63 "paymentRules": [ 64 { 65 "ruleID": "RULE_001", 66 "version": "1.0", 67 "name": "Use Paystack as a failover for Flutterwave", 68 "description": "Route transactions to Paystack if Flutterwave fails" 69 } 70 ], 71 "settlementData": { 72 "settlementDate": "2024-03-21T10:00:00Z", 73 "settlementBatchId": "BATCH_001", 74 "destinationBankAccountName": "Access Bank", 75 "destinationBankAccountNumber": "0690000000" 76 } 77 }

Retrieves the details of a specific transaction, including checkout session, payment attempts, and refunds.

Path parameters

transactionIdstringRequired

Unique identifier for the transaction.

Response

Transaction details retrieved successfully.

transactionIdstring or null

Unique identifier for the transaction.

statusstring or null

Current status of the transaction.

createdAtlist of datetimes or null

checkoutSessionobject or null

paymentAttemptslist of objects or null

refundslist of objects or null

paymentRuleslist of objects or null

List of payment rules that affected the transaction.

settlementDataobject or null

Optional settlement data for transactions in the "settled" state.

Path parameters

Response

Errors