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.

transactionIdstringOptional

Unique identifier for the transaction.

statusstringOptional

Current status of the transaction.

createdAtlist of datetimesOptional

checkoutSessionobjectOptional

paymentAttemptslist of objectsOptional

refundslist of objectsOptional

paymentRuleslist of objectsOptional

List of payment rules that affected the transaction.

settlementDataobjectOptional

Optional settlement data for transactions in the “settled” state.

Path parameters

Response

Errors