Get all chargebacks

GET

https://api-sandbox.coinflow.cash/api/merchant/chargebacks

GET

/api/merchant/chargebacks

1 import requests
2 
3 url = "https://api-sandbox.coinflow.cash/api/merchant/chargebacks"
4 
5 headers = {"Authorization": "<apiKey>"}
6 
7 response = requests.get(url, headers=headers)
8 
9 print(response.json())

200Retrieved

1 [
2   {
3     "payment": {
4       "_id": "string",
5       "paymentId": "string",
6       "totals": {
7         "subtotal": {
8           "cents": 1,
9           "currency": "USD"
10         },
11         "creditCardFees": {
12           "cents": 1,
13           "currency": "USD"
14         },
15         "chargebackProtectionFees": {
16           "cents": 1,
17           "currency": "USD"
18         },
19         "gasFees": {
20           "cents": 1,
21           "currency": "USD"
22         },
23         "fxFees": {
24           "cents": 1,
25           "currency": "USD"
26         },
27         "total": {
28           "cents": 1,
29           "currency": "USD"
30         },
31         "networkFees": {
32           "cents": 1,
33           "currency": "USD"
34         },
35         "merchantPaidCreditCardFees": {
36           "cents": 1,
37           "currency": "USD"
38         },
39         "merchantPaidChargebackProtectionFees": {
40           "cents": 1,
41           "currency": "USD"
42         },
43         "merchantPaidGasFees": {
44           "cents": 1,
45           "currency": "USD"
46         },
47         "merchantPaidFxFees": {
48           "cents": 1,
49           "currency": "USD"
50         },
51         "merchantPaidNetworkFees": {
52           "cents": 1,
53           "currency": "USD"
54         }
55       },
56       "customer": "string",
57       "merchant": "string",
58       "chargebackProtectionDecision": "approved",
59       "createdAt": "2024-01-15T09:30:00Z",
60       "error": "string",
61       "signature": "string",
62       "webhookInfo": null,
63       "cardInfo": {
64         "processor": "payarc",
65         "authCode": "string",
66         "status": "AUTHORIZED",
67         "storedTransactionType": "MOBILE",
68         "authorizationPaymentReference": "string",
69         "originalPaymentId": "string",
70         "statementDescriptor": "string",
71         "interchangeKey": "string",
72         "fraudReport": {
73           "requestId": "string",
74           "report": {},
75           "reportedAt": "2024-01-15T09:30:00Z"
76         },
77         "enhancedTxInfo": {
78           "firstName": "string",
79           "lastName": "string",
80           "streetAddress": "string",
81           "city": "string",
82           "state": "string",
83           "zip": "string",
84           "country": "string",
85           "email": "string",
86           "bin": "string",
87           "ip": "string",
88           "userAgent": "string",
89           "expMonth": "string",
90           "expYear": "string",
91           "eci": "string",
92           "avsResponseCode": "A",
93           "cvvResponseCode": "M",
94           "binLocation": {
95             "cardType": "credit",
96             "cardName": "string",
97             "cardSegment": "consumer",
98             "country": "AF",
99             "bankName": "string"
100           },
101           "ipLocation": {
102             "zip": "string",
103             "city": "string",
104             "isp": "string",
105             "region": "string",
106             "country": "string",
107             "lon": "string",
108             "lat": "string",
109             "hosting": true,
110             "mobile": true,
111             "proxy": true
112           },
113           "nsureDecisionInsights": {
114             "predictionInsights": [
115               {
116                 "value": 1.1,
117                 "description": "string",
118                 "id": "string"
119               }
120             ],
121             "decisionComponents": [
122               {
123                 "description": "string",
124                 "type": "string"
125               }
126             ],
127             "decision": "string"
128           },
129           "orchestrationInfo": {
130             "ruleId": "string",
131             "ruleUsed": "string",
132             "resolvedPath": "string",
133             "graphTraversal": [
134               {
135                 "nodeId": "string",
136                 "nodeType": "action",
137                 "outcome": "string",
138                 "operation": "string"
139               }
140             ],
141             "processorList": [
142               "payarc"
143             ],
144             "successfulProcessor": "payarc",
145             "usedFallback": true
146           }
147         },
148         "transaction": "string",
149         "secureTransactionId": "string",
150         "processed3DS": "Required",
151         "cardType": "VISA",
152         "last4": "string",
153         "token": "string",
154         "mobileWallet": "applePay"
155       },
156       "bankTransferInfo": {
157         "refundReview": true,
158         "processor": "mock",
159         "status": "PENDING",
160         "reason": "string",
161         "token": "string",
162         "batchedAt": "2024-01-15T09:30:00Z",
163         "refundTransferId": "string",
164         "transaction": "string"
165       },
166       "pixInfo": {
167         "expiration": "2024-01-15T09:30:00Z",
168         "processor": "brla",
169         "status": "INITIATED",
170         "reason": "string",
171         "processed": "2024-01-15T09:30:00Z",
172         "transaction": "string",
173         "tokenSubtotal": {
174           "address": "string",
175           "amount": 1.1,
176           "decimals": 1.1
177         }
178       },
179       "ibanInfo": {
180         "expiration": "2024-01-15T09:30:00Z",
181         "token": "string",
182         "processor": "merge",
183         "status": "INITIATED",
184         "accountHolder": "string",
185         "reason": "string",
186         "transactionId": "string",
187         "processed": "2024-01-15T09:30:00Z",
188         "tokenSubtotal": {
189           "address": "string",
190           "amount": 1.1,
191           "decimals": 1.1
192         },
193         "transaction": "string"
194       },
195       "wireInfo": {
196         "status": "INITIATED",
197         "processor": "braid",
198         "token": "string",
199         "memo": "string",
200         "expiration": "2024-01-15T09:30:00Z",
201         "transaction": "string",
202         "tokenSubtotal": {
203           "address": "string",
204           "amount": 1.1,
205           "decimals": 1.1
206         },
207         "processed": "2024-01-15T09:30:00Z",
208         "transactionId": "string",
209         "reason": "string"
210       },
211       "cryptoInfo": {
212         "status": "INITIATED",
213         "overpaymentAmount": "string",
214         "actualPaymentAmountUSD": "string",
215         "depositAddress": "string",
216         "refundAddress": "string",
217         "refundTransactionUrl": "string",
218         "refundTransactionHash": "string",
219         "sessionId": "string",
220         "reason": "string",
221         "tokenLogoUrl": "string",
222         "blockchainLogoUrl": "string",
223         "tokenAmount": "string",
224         "token": "string",
225         "originatingTransactionHash": "string",
226         "originatingWallet": "string",
227         "processed": "2024-01-15T09:30:00Z",
228         "transaction": "string",
229         "tokenSubtotal": {
230           "address": "string",
231           "amount": 1.1,
232           "decimals": 1.1
233         }
234       },
235       "instantInfo": {
236         "ip": "string",
237         "userAgent": "string",
238         "token": "string",
239         "expiration": "2024-01-15T09:30:00Z",
240         "processor": "mock",
241         "status": "REGISTERED",
242         "ipLocation": {
243           "zip": "string",
244           "city": "string",
245           "isp": "string",
246           "region": "string",
247           "country": "string",
248           "lon": "string",
249           "lat": "string",
250           "hosting": true,
251           "mobile": true,
252           "proxy": true
253         },
254         "transaction": "string",
255         "tokenSubtotal": {
256           "address": "string",
257           "amount": 1.1,
258           "decimals": 1.1
259         },
260         "reason": "string",
261         "processed": "2024-01-15T09:30:00Z",
262         "url": "string"
263       },
264       "exchangeInfo": {
265         "amount": {
266           "gasFees": {
267             "cents": 1,
268             "currency": "USD"
269           },
270           "chargebackProtectionFees": {
271             "cents": 1,
272             "currency": "USD"
273           },
274           "creditCardFees": {
275             "cents": 1,
276             "currency": "USD"
277           },
278           "subtotal": {
279             "cents": 1,
280             "currency": "USD"
281           }
282         },
283         "rate": 1.1,
284         "base": {
285           "cents": 1,
286           "currency": "USD"
287         }
288       },
289       "subscription": "string",
290       "settlementType": "Credits",
291       "blockchain": "solana",
292       "redemptionCheck": true,
293       "marketplaceInfo": {
294         "marketplaceFee": {
295           "cents": 1,
296           "currency": "USD"
297         },
298         "marketplaceSettlement": {
299           "cents": 1,
300           "currency": "USD"
301         },
302         "sellerSettlement": {
303           "cents": 1,
304           "currency": "USD"
305         },
306         "feePercentage": 1.1,
307         "fixedFee": {
308           "cents": 1,
309           "currency": "USD"
310         }
311       },
312       "destination": "string",
313       "overrideAuditLog": {
314         "reason": "customer_override",
315         "editor": "string",
316         "editorType": "Coinflow",
317         "overriddenAt": "2024-01-15T09:30:00Z",
318         "ipAddress": "string",
319         "nsureOverrideReason": "internalTesting"
320       },
321       "customerUsdcTransferData": {
322         "from": "string",
323         "to": "string",
324         "value": "string",
325         "validAfter": "string",
326         "validBefore": "string",
327         "nonce": "string",
328         "v": 1.1,
329         "r": "string",
330         "s": "string"
331       },
332       "delayedSettlement": {
333         "isDisbursed": true,
334         "days": 1.1,
335         "scheduledDate": "2024-01-15T09:30:00Z",
336         "isScheduled": true,
337         "disbursedAt": "2024-01-15T09:30:00Z"
338       },
339       "refundInfo": {
340         "count": 1.1,
341         "refundedAt": "2024-01-15T09:30:00Z",
342         "amount": {
343           "cents": 1,
344           "currency": "USD"
345         }
346       }
347     },
348     "merchant": "string",
349     "customer": "string",
350     "secureDs": {
351       "transactionId": "string",
352       "customer": "string",
353       "merchantId": "string",
354       "cardType": "VISA",
355       "authenticationStatus": "Frictionless",
356       "challengeState": "NotApplicable",
357       "createdAt": "2024-01-15T09:30:00Z",
358       "updatedAt": "2024-01-15T09:30:00Z",
359       "errorResponse": {
360         "threeDSecureResponse": {
361           "transStatusReason": "string",
362           "transStatus": "string"
363         }
364       },
365       "cavv": "string",
366       "eci": "string",
367       "dsTransactionId": "string",
368       "acsTransactionId": "string",
369       "version": "string"
370     },
371     "refund": {
372       "_id": "string",
373       "totals": {
374         "subtotal": {
375           "cents": 1,
376           "currency": "USD"
377         },
378         "processorFees": {
379           "cents": 1,
380           "currency": "USD"
381         },
382         "total": {
383           "cents": 1,
384           "currency": "USD"
385         },
386         "rate": 1.1,
387         "resolution": {
388           "cents": 1,
389           "currency": "USD"
390         },
391         "adjustment": {
392           "cents": 1,
393           "currency": "USD"
394         }
395       },
396       "customer": "string",
397       "merchant": "string",
398       "payment": "string",
399       "status": "Pending",
400       "outstanding": {
401         "cents": 1
402       },
403       "source": "Credits",
404       "method": "Card",
405       "provider": "string",
406       "createdAt": "2024-01-15T09:30:00Z",
407       "updatedAt": "2024-01-15T09:30:00Z",
408       "signature": "string",
409       "invoicedAt": "2024-01-15T09:30:00Z",
410       "reason": "userCancellation",
411       "refundedBy": {
412         "editor": "string",
413         "editorType": "Coinflow",
414         "ipAddress": "string"
415       }
416     }
417   }
418 ]

Authentication

Authorizationstring

The API key of the merchant - see https://docs.coinflow.cash/api-reference/api-reference/authentication/get-session-key

Authorizationstring

API Key authentication via header

Query parameters

limitdoubleOptional

pagedoubleOptional

statusstringOptional

searchstringOptional

sortBystringOptional

sortDirectiondoubleOptional

respondedbooleanOptional

discrepancybooleanOptional

processorstringOptional

protectionstringOptional

threeDSecurestringOptional

merchantIdstringOptional

sincestringOptional

untilstringOptional

reasonCodestringOptional

Response

paymentobject

merchantstring

customerstring

secureDsobject

refundobject