Get all chargebacks

GET

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

GET

/api/merchant/chargebacks

$ curl https://api-sandbox.coinflow.cash/api/merchant/chargebacks \
>      -H "Authorization: <apiKey>"

200Retrieved

1 [
2   {
3     "createdAt": "2024-01-15T09:30:00Z",
4     "updatedAt": "2024-01-15T09:30:00Z",
5     "payment": {
6       "_id": "string",
7       "paymentId": "string",
8       "totals": {
9         "subtotal": {
10           "cents": 1,
11           "currency": "USD"
12         },
13         "creditCardFees": {
14           "cents": 1,
15           "currency": "USD"
16         },
17         "chargebackProtectionFees": {
18           "cents": 1,
19           "currency": "USD"
20         },
21         "gasFees": {
22           "cents": 1,
23           "currency": "USD"
24         },
25         "fxFees": {
26           "cents": 1,
27           "currency": "USD"
28         },
29         "total": {
30           "cents": 1,
31           "currency": "USD"
32         },
33         "networkFees": {
34           "cents": 1,
35           "currency": "USD"
36         },
37         "payInFees": {
38           "cents": 1,
39           "currency": "USD"
40         },
41         "reserve": {
42           "cents": 1,
43           "currency": "USD"
44         },
45         "merchantPaidCreditCardFees": {
46           "cents": 1,
47           "currency": "USD"
48         },
49         "merchantPaidChargebackProtectionFees": {
50           "cents": 1,
51           "currency": "USD"
52         },
53         "merchantPaidGasFees": {
54           "cents": 1,
55           "currency": "USD"
56         },
57         "merchantPaidFxFees": {
58           "cents": 1,
59           "currency": "USD"
60         },
61         "merchantPaidNetworkFees": {
62           "cents": 1,
63           "currency": "USD"
64         }
65       },
66       "customer": "string",
67       "merchant": "string",
68       "chargebackProtectionDecision": "approved",
69       "createdAt": "2024-01-15T09:30:00Z",
70       "paymentIntentId": "string",
71       "liabilityOwner": "coinflow",
72       "error": "string",
73       "signature": "string",
74       "webhookInfo": {
75         "example": "string"
76       },
77       "velocityDate": "2024-01-15T09:30:00Z",
78       "cardInfo": {
79         "processor": "payarc",
80         "authCode": "string",
81         "status": "AUTHORIZED",
82         "reviewStage": "preAuthorization",
83         "nSureTransactionId": "string",
84         "storedTransactionType": "MOBILE",
85         "authorizationPaymentReference": "string",
86         "originalPaymentId": "string",
87         "statementDescriptor": "string",
88         "interchangeKey": "string",
89         "fraudReport": {
90           "requestId": "string",
91           "report": {},
92           "reportedAt": "2024-01-15T09:30:00Z"
93         },
94         "enhancedTxInfo": {
95           "firstName": "string",
96           "lastName": "string",
97           "streetAddress": "string",
98           "city": "string",
99           "state": "string",
100           "zip": "string",
101           "country": "string",
102           "email": "string",
103           "bin": "string",
104           "ip": "string",
105           "userAgent": "string",
106           "expMonth": "string",
107           "expYear": "string",
108           "eci": "string",
109           "avsResponseCode": "A",
110           "cvvResponseCode": "M",
111           "binLocation": {
112             "cardType": "credit",
113             "cardName": "string",
114             "cardSegment": "consumer",
115             "country": "AF",
116             "bankName": "string"
117           },
118           "ipLocation": {
119             "zip": "string",
120             "city": "string",
121             "isp": "string",
122             "region": "string",
123             "country": "string",
124             "lon": "string",
125             "lat": "string",
126             "hosting": true,
127             "mobile": true,
128             "proxy": true
129           },
130           "nsureDecisionInsights": {
131             "predictionInsights": [
132               {
133                 "value": 1.1,
134                 "description": "string",
135                 "id": "string"
136               }
137             ],
138             "decisionComponents": [
139               {
140                 "description": "string",
141                 "type": "string"
142               }
143             ],
144             "decision": "string"
145           },
146           "orchestrationInfo": {
147             "ruleId": "string",
148             "ruleUsed": "string",
149             "resolvedPath": "string",
150             "graphTraversal": [
151               {
152                 "nodeId": "string",
153                 "nodeType": "action",
154                 "outcome": "string",
155                 "operation": "string"
156               }
157             ],
158             "processorList": [
159               "payarc"
160             ],
161             "successfulProcessor": "payarc",
162             "usedFallback": true,
163             "failedAttempts": [
164               {
165                 "processor": "payarc",
166                 "paymentId": "string",
167                 "authCode": "string"
168               }
169             ]
170           }
171         },
172         "transaction": "string",
173         "secureTransactionId": "string",
174         "processed3DS": "Required",
175         "cardType": "VISA",
176         "last4": "string",
177         "token": "string",
178         "mobileWallet": "applePay",
179         "authOnly": true
180       },
181       "bankTransferInfo": {
182         "refundReview": true,
183         "processor": "mock",
184         "status": "PENDING",
185         "reason": "string",
186         "token": "string",
187         "batchedAt": "2024-01-15T09:30:00Z",
188         "refundTransferId": "string",
189         "transaction": "string"
190       },
191       "pixInfo": {
192         "expiration": "2024-01-15T09:30:00Z",
193         "processor": "brla",
194         "status": "INITIATED",
195         "reason": "string",
196         "processed": "2024-01-15T09:30:00Z",
197         "transaction": "string",
198         "tokenSubtotal": {
199           "address": "string",
200           "amount": 1.1,
201           "decimals": 1.1
202         }
203       },
204       "ibanInfo": {
205         "expiration": "2024-01-15T09:30:00Z",
206         "token": "string",
207         "processor": "merge",
208         "status": "INITIATED",
209         "reference": "string",
210         "failedAttempts": [
211           {
212             "transactionId": "string",
213             "processed": "2024-01-15T09:30:00Z",
214             "reason": "string"
215           }
216         ],
217         "accountHolder": "string",
218         "reason": "string",
219         "transactionId": "string",
220         "processed": "2024-01-15T09:30:00Z",
221         "tokenSubtotal": {
222           "address": "string",
223           "amount": 1.1,
224           "decimals": 1.1
225         },
226         "transaction": "string"
227       },
228       "wireInfo": {
229         "status": "INITIATED",
230         "processor": "braid",
231         "token": "string",
232         "memo": "string",
233         "expiration": "2024-01-15T09:30:00Z",
234         "transaction": "string",
235         "tokenSubtotal": {
236           "address": "string",
237           "amount": 1.1,
238           "decimals": 1.1
239         },
240         "processed": "2024-01-15T09:30:00Z",
241         "transactionId": "string",
242         "braidWireReferencePaymentId": "string",
243         "reason": "string"
244       },
245       "cashAppInfo": {
246         "status": "INITIATED",
247         "processor": "mock",
248         "referenceId": "string",
249         "cashAppLink": "string",
250         "expiresAt": "2024-01-15T09:30:00Z",
251         "depositAddress": "string",
252         "transaction": "string"
253       },
254       "paypalInfo": {
255         "status": "INITIATED",
256         "processor": "mock",
257         "token": "string",
258         "authOnly": true,
259         "transaction": "string",
260         "capturePending": true,
261         "sandboxSimulations": {
262           "refundFailure": true,
263           "captureFailure": true,
264           "authorizationFailure": true
265         }
266       },
267       "venmoInfo": {
268         "status": "INITIATED",
269         "processor": "mock",
270         "token": "string",
271         "authOnly": true,
272         "transaction": "string",
273         "capturePending": true,
274         "sandboxSimulations": {
275           "refundFailure": true,
276           "captureFailure": true,
277           "authorizationFailure": true
278         }
279       },
280       "apaInfo": {
281         "status": "INITIATED",
282         "processor": "apa",
283         "apaTransactionId": "string",
284         "credentialType": "PHONE",
285         "credentialValue": "string",
286         "transaction": "string",
287         "transactionHash": "string",
288         "rail": "string",
289         "reason": "string",
290         "processed": "2024-01-15T09:30:00Z"
291       },
292       "interacInfo": {
293         "status": "INITIATED",
294         "processor": "mock",
295         "identityId": "string",
296         "referenceId": "string",
297         "expiration": "2024-01-15T09:30:00Z",
298         "email": "string",
299         "phone": "string",
300         "transaction": "string",
301         "processed": "2024-01-15T09:30:00Z",
302         "reason": "string"
303       },
304       "cryptoInfo": {
305         "status": "INITIATED",
306         "tier": "stables",
307         "paymentCurrency": "string",
308         "overpaymentAmount": "string",
309         "actualPaymentAmountUSD": "string",
310         "depositAddress": "string",
311         "refundAddress": "string",
312         "refundTransactionHash": "string",
313         "sessionId": "string",
314         "reason": "string",
315         "tokenLogoUrl": "string",
316         "blockchainLogoUrl": "string",
317         "tokenAmount": "string",
318         "token": "string",
319         "sponsoredTransactionHash": "string",
320         "originatingTransactionHash": "string",
321         "originatingWallet": "string",
322         "processed": "2024-01-15T09:30:00Z",
323         "transaction": "string",
324         "tokenSubtotal": {
325           "address": "string",
326           "amount": 1.1,
327           "decimals": 1.1
328         }
329       },
330       "exchangeInfo": {
331         "amount": {
332           "fxFees": {
333             "cents": 1,
334             "currency": "USD"
335           },
336           "total": {
337             "cents": 1,
338             "currency": "USD"
339           },
340           "networkFees": {
341             "cents": 1,
342             "currency": "USD"
343           },
344           "payInFees": {
345             "cents": 1,
346             "currency": "USD"
347           },
348           "reserve": {
349             "cents": 1,
350             "currency": "USD"
351           },
352           "merchantPaidCreditCardFees": {
353             "cents": 1,
354             "currency": "USD"
355           },
356           "merchantPaidChargebackProtectionFees": {
357             "cents": 1,
358             "currency": "USD"
359           },
360           "merchantPaidGasFees": {
361             "cents": 1,
362             "currency": "USD"
363           },
364           "merchantPaidFxFees": {
365             "cents": 1,
366             "currency": "USD"
367           },
368           "merchantPaidNetworkFees": {
369             "cents": 1,
370             "currency": "USD"
371           },
372           "gasFees": {
373             "cents": 1,
374             "currency": "USD"
375           },
376           "chargebackProtectionFees": {
377             "cents": 1,
378             "currency": "USD"
379           },
380           "creditCardFees": {
381             "cents": 1,
382             "currency": "USD"
383           },
384           "subtotal": {
385             "cents": 1,
386             "currency": "USD"
387           }
388         },
389         "rate": 1.1,
390         "base": {
391           "cents": 1,
392           "currency": "USD"
393         }
394       },
395       "subscription": "string",
396       "settlementType": "Credits",
397       "blockchain": "solana",
398       "wallet": "string",
399       "redemptionCheck": true,
400       "marketplaceInfo": {
401         "marketplaceFee": {
402           "cents": 1,
403           "currency": "USD"
404         },
405         "marketplaceSettlement": {
406           "cents": 1,
407           "currency": "USD"
408         },
409         "sellerSettlement": {
410           "cents": 1,
411           "currency": "USD"
412         },
413         "feePercentage": 1.1,
414         "fixedFee": {
415           "cents": 1,
416           "currency": "USD"
417         }
418       },
419       "destination": "string",
420       "destinationSettlementToken": "string",
421       "overrideAuditLog": {
422         "reason": "customer_override",
423         "editor": "string",
424         "editorType": "Coinflow",
425         "overriddenAt": "2024-01-15T09:30:00Z",
426         "ipAddress": "string",
427         "nsureOverrideReason": "internalTesting"
428       },
429       "customerUsdcTransferData": {
430         "from": "string",
431         "to": "string",
432         "value": "string",
433         "validAfter": "string",
434         "validBefore": "string",
435         "nonce": "string",
436         "v": 1.1,
437         "r": "string",
438         "s": "string"
439       },
440       "customerUsdcTransferDataV2": {
441         "from": "string",
442         "to": "string",
443         "value": "string",
444         "validAfter": "string",
445         "validBefore": "string",
446         "nonce": "string",
447         "signature": "string"
448       },
449       "delayedSettlement": {
450         "isDisbursed": true,
451         "days": 1.1,
452         "scheduledDate": "2024-01-15T09:30:00Z",
453         "isScheduled": true,
454         "disbursedAt": "2024-01-15T09:30:00Z"
455       },
456       "referrer": "string",
457       "alertStatus": "open",
458       "refundInfo": {
459         "count": 1.1,
460         "refundedAt": "2024-01-15T09:30:00Z",
461         "amount": {
462           "cents": 1,
463           "currency": "USD"
464         }
465       },
466       "userLocation": {
467         "lng": 1.1,
468         "lat": 1.1,
469         "resolvedState": "string",
470         "resolvedCountry": "string"
471       },
472       "entityTag": {
473         "coinflowEntity": "US",
474         "licensedEntity": "string"
475       },
476       "vendorTransfer": {
477         "internal": "string",
478         "external": "string"
479       }
480     },
481     "chargebackId": "string",
482     "reasonCode": "string",
483     "reasonDescription": "string",
484     "respondByDate": "2024-01-15T09:30:00Z",
485     "responded": true,
486     "merchant": "string",
487     "customer": "string",
488     "secureDs": {
489       "transactionId": "string",
490       "customer": "string",
491       "merchantId": "string",
492       "cardType": "VISA",
493       "authenticationStatus": "Frictionless",
494       "challengeState": "NotApplicable",
495       "createdAt": "2024-01-15T09:30:00Z",
496       "updatedAt": "2024-01-15T09:30:00Z",
497       "errorResponse": {
498         "threeDSecureResponse": {
499           "transStatusReason": "string",
500           "transStatus": "string"
501         }
502       },
503       "cavv": "string",
504       "eci": "string",
505       "dsTransactionId": "string",
506       "acsTransactionId": "string",
507       "version": "string"
508     },
509     "refund": {
510       "_id": "string",
511       "totals": {
512         "subtotal": {
513           "cents": 1,
514           "currency": "USD"
515         },
516         "processorFees": {
517           "cents": 1,
518           "currency": "USD"
519         },
520         "total": {
521           "cents": 1,
522           "currency": "USD"
523         },
524         "rate": 1.1,
525         "resolution": {
526           "cents": 1,
527           "currency": "USD"
528         },
529         "adjustment": {
530           "cents": 1,
531           "currency": "USD"
532         }
533       },
534       "customer": "string",
535       "merchant": "string",
536       "payment": "string",
537       "status": "Pending",
538       "reimbursementStatus": "Pending",
539       "outstanding": {
540         "cents": 1
541       },
542       "source": "Credits",
543       "method": "Card",
544       "provider": "string",
545       "createdAt": "2024-01-15T09:30:00Z",
546       "updatedAt": "2024-01-15T09:30:00Z",
547       "signature": "string",
548       "reimbursementId": "string",
549       "invoicedAt": "2024-01-15T09:30:00Z",
550       "reason": "userCancellation",
551       "refundedBy": {
552         "editor": "string",
553         "editorType": "Coinflow",
554         "ipAddress": "string"
555       },
556       "failureReason": "string",
557       "cryptoRefundInfo": {
558         "refundAddress": "string",
559         "denominationType": "usd",
560         "refundTransactionHash": "string",
561         "refundTransactionUrl": "string",
562         "amountUSD": "string",
563         "tokenAmount": "string",
564         "paymentCurrency": "string"
565       },
566       "walletDebitStatus": "pending",
567       "walletDebitTxHash": "string",
568       "returnSignature": "string"
569     },
570     "merchantRespondedAt": "2024-01-15T09:30:00Z",
571     "responseFileKey": "string",
572     "ignore": true,
573     "discrepancy": true,
574     "loadedOn": "2024-01-15T09:30:00Z",
575     "decidedAt": "2024-01-15T09:30:00Z",
576     "updates": [
577       {
578         "transactionType": "string",
579         "code": "string",
580         "description": "string",
581         "postedAt": "2024-01-15T09:30:00Z"
582       }
583     ],
584     "autoDebitStatus": "pending",
585     "walletDebitTxHash": "string",
586     "walletCreditTxHash": "string"
587   }
588 ]

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

createdAtdatetime

updatedAtdatetime

paymentobject

chargebackIdstring

reasonCodestring

reasonDescriptionstring

respondByDatedatetime

respondedboolean

merchantstring

customerstring

secureDsobject

refundobject

merchantRespondedAtdatetime

responseFileKeystring

ignoreboolean

discrepancyboolean

loadedOndatetime

decidedAtdatetime

updateslist of objects

autoDebitStatusenum

walletDebitTxHashstring

walletCreditTxHashstring