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

[
  {
    "createdAt": "2024-01-15T09:30:00Z",
    "_id": "string",
    "invoiceId": "string",
    "outstanding": {
      "cents": 1,
      "currency": "USD"
    },
    "merchant": "string",
    "updatedAt": "2024-01-15T09:30:00Z",
    "payment": {
      "_id": "string",
      "paymentId": "string",
      "totals": {
        "subtotal": {
          "cents": 1,
          "currency": "USD"
        },
        "creditCardFees": {
          "cents": 1,
          "currency": "USD"
        },
        "chargebackProtectionFees": {
          "cents": 1,
          "currency": "USD"
        },
        "gasFees": {
          "cents": 1,
          "currency": "USD"
        },
        "fxFees": {
          "cents": 1,
          "currency": "USD"
        },
        "total": {
          "cents": 1,
          "currency": "USD"
        },
        "networkFees": {
          "cents": 1,
          "currency": "USD"
        },
        "payInFees": {
          "cents": 1,
          "currency": "USD"
        },
        "reserve": {
          "cents": 1,
          "currency": "USD"
        },
        "merchantPaidCreditCardFees": {
          "cents": 1,
          "currency": "USD"
        },
        "merchantPaidChargebackProtectionFees": {
          "cents": 1,
          "currency": "USD"
        },
        "merchantPaidGasFees": {
          "cents": 1,
          "currency": "USD"
        },
        "merchantPaidFxFees": {
          "cents": 1,
          "currency": "USD"
        },
        "merchantPaidNetworkFees": {
          "cents": 1,
          "currency": "USD"
        },
        "invoicedCreditCardFees": {
          "cents": 1,
          "currency": "USD"
        },
        "invoicedChargebackProtectionFees": {
          "cents": 1,
          "currency": "USD"
        },
        "invoicedGasFees": {
          "cents": 1,
          "currency": "USD"
        },
        "invoicedFxFees": {
          "cents": 1,
          "currency": "USD"
        },
        "invoicedNetworkFees": {
          "cents": 1,
          "currency": "USD"
        },
        "rebate": {
          "cents": 1,
          "currency": "USD"
        },
        "invoicedRebate": {
          "cents": 1,
          "currency": "USD"
        }
      },
      "customer": "string",
      "merchant": "string",
      "chargebackProtectionDecision": "approved",
      "createdAt": "2024-01-15T09:30:00Z",
      "paymentIntentId": "string",
      "idempotencyKey": "string",
      "liabilityOwner": "coinflow-entity",
      "overrideChargebackProtectionDecision": true,
      "chargebackProtectionAccountType": "guest",
      "doNotReviewChargebackProtection": true,
      "cart": [
        {
          "productName": "string",
          "productType": "inGameProduct",
          "listPrice": {
            "currency": "string",
            "valueInCurrency": 1.1
          },
          "quantity": 1.1,
          "rawProductData": {
            "example": "string"
          },
          "seller": {
            "id": "string",
            "email": "string",
            "firstName": "string",
            "lastName": "string",
            "dob": "string",
            "rawSellerData": {}
          },
          "transactionHistory": [
            {
              "txType": "string",
              "chain": "string",
              "paymentAmount": "string",
              "paymentToken": "string",
              "to": "string",
              "from": "string",
              "registryContract": "string",
              "assetID": "string",
              "txTime": "string",
              "blockNumber": 1.1,
              "txHash": "string"
            }
          ]
        }
      ],
      "sessionInfo": {
        "userAgent": "string",
        "endUserIp": "string",
        "deviceId": "string",
        "verisoulSessionId": "string"
      },
      "error": "string",
      "signature": "string",
      "webhookInfo": {
        "example": "string"
      },
      "velocityDate": "2024-01-15T09:30:00Z",
      "cardInfo": {
        "processor": "payarc",
        "authCode": "string",
        "status": "AUTHORIZED",
        "nameMatchThreshold": 1.1,
        "nameMatchScore": 1.1,
        "smartBinReordered": "randomized",
        "normalizedIssuer": "string",
        "storedTransactionType": "MOBILE",
        "authorizationPaymentReference": "string",
        "originalPaymentId": "string",
        "statementDescriptor": "string",
        "interchangeKey": "string",
        "fraudReport": {
          "requestId": "string",
          "report": {},
          "reportedAt": "2024-01-15T09:30:00Z"
        },
        "enhancedTxInfo": {
          "firstName": "string",
          "lastName": "string",
          "nameOnFile": "string",
          "streetAddress": "string",
          "city": "string",
          "state": "string",
          "zip": "string",
          "country": "string",
          "email": "string",
          "bin": "string",
          "ip": "string",
          "userAgent": "string",
          "expMonth": "string",
          "expYear": "string",
          "eci": "string",
          "avsResponseCode": "A",
          "cvvResponseCode": "M",
          "binLocation": {
            "cardType": "credit",
            "cardName": "string",
            "cardSegment": "consumer",
            "country": "AF",
            "bankName": "string",
            "normalizedIssuer": "string",
            "bin": "string"
          },
          "ipLocation": {
            "lat": "string",
            "lon": "string",
            "country": "string",
            "region": "string",
            "isp": "string",
            "city": "string",
            "zip": "string",
            "proxy": true,
            "mobile": true,
            "hosting": true
          },
          "declineExplanation": {
            "summary": "string",
            "explanation": "string",
            "keyFactors": [
              "string"
            ],
            "remediation": "string",
            "model": "string",
            "promptVersion": 1.1,
            "generatedAt": "2024-01-15T09:30:00Z"
          },
          "declineExplanationFailure": {
            "reason": "string",
            "failedAt": "2024-01-15T09:30:00Z"
          },
          "orchestrationInfo": {
            "ruleId": "string",
            "ruleUsed": "string",
            "resolvedPath": "string",
            "graphTraversal": [
              {
                "nodeId": "string",
                "nodeType": "action",
                "outcome": "string",
                "operation": "string"
              }
            ],
            "processorList": [
              "payarc"
            ],
            "successfulProcessor": "payarc",
            "usedFallback": true,
            "failedAttempts": [
              {
                "processor": "payarc",
                "paymentId": "string",
                "authCode": "string"
              }
            ]
          }
        },
        "tokenSubtotal": {
          "address": "string",
          "amount": 1.1,
          "decimals": 1.1
        },
        "transaction": "string",
        "secureTransactionId": "string",
        "processed3DS": "Required",
        "cardType": "VISA",
        "last4": "string",
        "token": "string",
        "mobileWallet": "applePay",
        "authOnly": true
      },
      "bankTransferInfo": {
        "refundReview": true,
        "processor": "mock",
        "status": "PENDING",
        "reasonDescription": "string",
        "reasonCode": "string",
        "achAuthorizationId": "string",
        "reason": "string",
        "token": "string",
        "batchedAt": "2024-01-15T09:30:00Z",
        "refundTransferId": "string",
        "transaction": "string"
      },
      "pixInfo": {
        "expiration": "2024-01-15T09:30:00Z",
        "processor": "avenia",
        "status": "INITIATED",
        "reason": "string",
        "processed": "2024-01-15T09:30:00Z",
        "transaction": "string",
        "tokenSubtotal": {
          "address": "string",
          "amount": 1.1,
          "decimals": 1.1
        }
      },
      "ibanInfo": {
        "expiration": "2024-01-15T09:30:00Z",
        "token": "string",
        "processor": "merge",
        "status": "INITIATED",
        "reference": "string",
        "failedAttempts": [
          {
            "transactionId": "string",
            "processed": "2024-01-15T09:30:00Z",
            "reason": "string"
          }
        ],
        "accountHolder": "string",
        "reason": "string",
        "transactionId": "string",
        "processed": "2024-01-15T09:30:00Z",
        "tokenSubtotal": {
          "address": "string",
          "amount": 1.1,
          "decimals": 1.1
        },
        "transaction": "string"
      },
      "wireInfo": {
        "status": "INITIATED",
        "processor": "braid",
        "token": "string",
        "memo": "string",
        "expiration": "2024-01-15T09:30:00Z",
        "transaction": "string",
        "tokenSubtotal": {
          "address": "string",
          "amount": 1.1,
          "decimals": 1.1
        },
        "processed": "2024-01-15T09:30:00Z",
        "transactionId": "string",
        "braidWireReferencePaymentId": "string",
        "reason": "string"
      },
      "cashAppInfo": {
        "status": "INITIATED",
        "processor": "mock",
        "referenceId": "string",
        "cashAppLink": "string",
        "expiresAt": "2024-01-15T09:30:00Z",
        "depositAddress": "string",
        "transaction": "string"
      },
      "paypalInfo": {
        "merchantId": "string",
        "status": "INITIATED",
        "processor": "mock",
        "token": "string",
        "payerId": "string",
        "email": "string",
        "payerName": "string",
        "payerFirstName": "string",
        "payerLastName": "string",
        "payerCountryCode": "string",
        "emailVerified": true,
        "phone": "string",
        "authOnly": true,
        "transaction": "string",
        "authorizationId": "string",
        "captureId": "string",
        "capturePending": true,
        "failureReason": "string",
        "sandboxSimulations": {
          "refundFailure": true,
          "captureFailure": true,
          "authorizationFailure": true
        },
        "decidedByInternalModels": true,
        "vaulted": true,
        "clientMetadataId": "string"
      },
      "venmoInfo": {
        "merchantId": "string",
        "status": "INITIATED",
        "processor": "mock",
        "token": "string",
        "payerId": "string",
        "email": "string",
        "payerName": "string",
        "payerFirstName": "string",
        "payerLastName": "string",
        "payerCountryCode": "string",
        "emailVerified": true,
        "phone": "string",
        "authOnly": true,
        "transaction": "string",
        "authorizationId": "string",
        "captureId": "string",
        "capturePending": true,
        "failureReason": "string",
        "vaulted": true,
        "clientMetadataId": "string",
        "sandboxSimulations": {
          "refundFailure": true,
          "captureFailure": true,
          "authorizationFailure": true
        }
      },
      "apaInfo": {
        "status": "INITIATED",
        "processor": "apa",
        "apaTransactionId": "string",
        "credentialType": "PHONE",
        "credentialValue": "string",
        "transaction": "string",
        "transactionHash": "string",
        "rail": "string",
        "reason": "string",
        "processed": "2024-01-15T09:30:00Z"
      },
      "interacInfo": {
        "status": "INITIATED",
        "processor": "mock",
        "identityId": "string",
        "referenceId": "string",
        "expiration": "2024-01-15T09:30:00Z",
        "email": "string",
        "phone": "string",
        "transaction": "string",
        "processed": "2024-01-15T09:30:00Z",
        "reason": "string"
      },
      "cryptoInfo": {
        "status": "INITIATED",
        "flexibleAmount": true,
        "tier": "stables",
        "paymentCurrency": "string",
        "overpaymentAmount": "string",
        "actualPaymentAmountUSD": "string",
        "expiresAt": "2024-01-15T09:30:00Z",
        "depositAddress": "string",
        "refundAddress": "string",
        "refundTransactionHash": "string",
        "sessionId": "string",
        "reason": "string",
        "tokenLogoUrl": "string",
        "blockchainLogoUrl": "string",
        "tokenAmount": "string",
        "token": "string",
        "sponsoredTransactionHash": "string",
        "originatingTransactionHash": "string",
        "originatingWallet": "string",
        "processed": "2024-01-15T09:30:00Z",
        "transaction": "string",
        "tokenSubtotal": {
          "address": "string",
          "amount": 1.1,
          "decimals": 1.1
        },
        "chainName": "string",
        "tokenId": "string",
        "chainId": "string",
        "provider": "glide"
      },
      "exchangeInfo": {
        "amount": {
          "fxFees": {
            "cents": 1,
            "currency": "USD"
          },
          "total": {
            "cents": 1,
            "currency": "USD"
          },
          "networkFees": {
            "cents": 1,
            "currency": "USD"
          },
          "payInFees": {
            "cents": 1,
            "currency": "USD"
          },
          "reserve": {
            "cents": 1,
            "currency": "USD"
          },
          "merchantPaidCreditCardFees": {
            "cents": 1,
            "currency": "USD"
          },
          "merchantPaidChargebackProtectionFees": {
            "cents": 1,
            "currency": "USD"
          },
          "merchantPaidGasFees": {
            "cents": 1,
            "currency": "USD"
          },
          "merchantPaidFxFees": {
            "cents": 1,
            "currency": "USD"
          },
          "merchantPaidNetworkFees": {
            "cents": 1,
            "currency": "USD"
          },
          "invoicedCreditCardFees": {
            "cents": 1,
            "currency": "USD"
          },
          "invoicedChargebackProtectionFees": {
            "cents": 1,
            "currency": "USD"
          },
          "invoicedGasFees": {
            "cents": 1,
            "currency": "USD"
          },
          "invoicedFxFees": {
            "cents": 1,
            "currency": "USD"
          },
          "invoicedNetworkFees": {
            "cents": 1,
            "currency": "USD"
          },
          "rebate": {
            "cents": 1,
            "currency": "USD"
          },
          "invoicedRebate": {
            "cents": 1,
            "currency": "USD"
          },
          "gasFees": {
            "cents": 1,
            "currency": "USD"
          },
          "chargebackProtectionFees": {
            "cents": 1,
            "currency": "USD"
          },
          "creditCardFees": {
            "cents": 1,
            "currency": "USD"
          },
          "subtotal": {
            "cents": 1,
            "currency": "USD"
          }
        },
        "rate": 1.1,
        "base": {
          "cents": 1,
          "currency": "USD"
        }
      },
      "subscription": "string",
      "settlementType": "Credits",
      "blockchain": "solana",
      "wallet": "string",
      "marketplaceInfo": {
        "marketplaceFee": {
          "cents": 1,
          "currency": "USD"
        },
        "marketplaceSettlement": {
          "cents": 1,
          "currency": "USD"
        },
        "sellerSettlement": {
          "cents": 1,
          "currency": "USD"
        },
        "feePercentage": 1.1,
        "fixedFee": {
          "cents": 1,
          "currency": "USD"
        }
      },
      "destination": "string",
      "destinationSettlementToken": "string",
      "overrideAuditLog": {
        "reason": "customer_override",
        "editor": "string",
        "editorType": "Coinflow",
        "overriddenAt": "2024-01-15T09:30:00Z",
        "ipAddress": "string"
      },
      "customerUsdcTransferData": {
        "from": "string",
        "to": "string",
        "value": "string",
        "validAfter": "string",
        "validBefore": "string",
        "nonce": "string",
        "v": 1.1,
        "r": "string",
        "s": "string"
      },
      "customerUsdcTransferDataV2": {
        "from": "string",
        "to": "string",
        "value": "string",
        "validAfter": "string",
        "validBefore": "string",
        "nonce": "string",
        "signature": "string"
      },
      "referrer": "string",
      "alertStatus": "open",
      "fundsReturnedAt": "2024-01-15T09:30:00Z",
      "refundInfo": {
        "count": 1.1,
        "refundedAt": "2024-01-15T09:30:00Z",
        "amount": {
          "cents": 1,
          "currency": "USD"
        }
      },
      "userLocation": {
        "lng": 1.1,
        "lat": 1.1,
        "resolvedState": "string",
        "resolvedCountry": "string"
      },
      "entityTag": {
        "coinflowEntity": "US"
      },
      "vendorTransfer": {
        "internal": "string",
        "external": [
          {
            "id": "string",
            "signature": "string"
          }
        ]
      },
      "feesInvoicedPeriod": "string",
      "invoiceId": "string",
      "outstanding": {
        "cents": 1,
        "currency": "USD"
      },
      "vendorInfo": {}
    },
    "chargebackId": "string",
    "reasonCode": "string",
    "reasonDescription": "string",
    "respondByDate": "2024-01-15T09:30:00Z",
    "responded": true,
    "customer": "string",
    "secureDs": {
      "transactionId": "string",
      "customer": "string",
      "merchantId": "string",
      "cardType": "VISA",
      "authenticationStatus": "Frictionless",
      "challengeState": "NotApplicable",
      "createdAt": "2024-01-15T09:30:00Z",
      "updatedAt": "2024-01-15T09:30:00Z",
      "threeDSProvider": "bt",
      "authenticationStatusReasonCode": "string",
      "errorResponse": {
        "threeDSecureResponse": {
          "transStatusReason": "string",
          "transStatus": "string"
        }
      },
      "cavv": "string",
      "eci": "string",
      "dsTransactionId": "string",
      "acsTransactionId": "string",
      "version": "string"
    },
    "refund": {
      "_id": "string",
      "totals": {
        "subtotal": {
          "cents": 1,
          "currency": "USD"
        },
        "processorFees": {
          "cents": 1,
          "currency": "USD"
        },
        "total": {
          "cents": 1,
          "currency": "USD"
        },
        "rate": 1.1,
        "resolution": {
          "cents": 1,
          "currency": "USD"
        },
        "adjustment": {
          "cents": 1,
          "currency": "USD"
        }
      },
      "customer": "string",
      "merchant": "string",
      "payment": "string",
      "status": "Pending",
      "reimbursementStatus": "Pending",
      "outstanding": {
        "cents": 1,
        "currency": "USD"
      },
      "source": "Credits",
      "method": "Card",
      "provider": "string",
      "createdAt": "2024-01-15T09:30:00Z",
      "updatedAt": "2024-01-15T09:30:00Z",
      "signature": "string",
      "reimbursementId": "string",
      "invoicedAt": "2024-01-15T09:30:00Z",
      "invoiceId": "string",
      "reason": "userCancellation",
      "refundedBy": {
        "editor": "string",
        "editorType": "Coinflow",
        "ipAddress": "string"
      },
      "failureReason": "string",
      "cryptoRefundInfo": {
        "refundAddress": "string",
        "denominationType": "usd",
        "refundTransactionHash": "string",
        "refundTransactionUrl": "string",
        "amountUSD": "string",
        "tokenAmount": "string",
        "paymentCurrency": "string"
      },
      "walletDebitStatus": "pending",
      "walletDebitTxHash": "string",
      "returnSignature": "string"
    },
    "shouldFight": true,
    "arn": "string",
    "merchantRespondedAt": "2024-01-15T09:30:00Z",
    "responseFileKey": "string",
    "accepted": true,
    "discrepancy": true,
    "loadedOn": "2024-01-15T09:30:00Z",
    "chargebackFeeCents": 1.1,
    "decidedAt": "2024-01-15T09:30:00Z",
    "updates": [
      {
        "transactionType": "string",
        "code": "string",
        "description": "string",
        "postedAt": "2024-01-15T09:30:00Z"
      }
    ],
    "disputedAmount": {
      "cents": 1,
      "currency": "USD"
    },
    "autoDebitStatus": "pending",
    "autoDebitAmountCents": 1.1,
    "walletDebitTxHash": "string",
    "walletCreditTxHash": "string",
    "reversed": true,
    "decidedLostAt": "2024-01-15T09:30:00Z"
  }
]

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

methodstringOptional

excludeMethodstringOptional

Response

createdAtdatetime

_idstring

invoiceIdstring

outstandingobject

merchantstring

updatedAtdatetime

paymentobject

chargebackIdstring

reasonCodestring

reasonDescriptionstring

respondByDatedatetime

respondedboolean

customerstring

secureDsobject

refundobject

shouldFightboolean

arnstringOptional

merchantRespondedAtdatetimeOptional

responseFileKeystringOptional

acceptedbooleanOptional

discrepancybooleanOptional

loadedOndatetimeOptional

chargebackFeeCentsdoubleOptional

decidedAtdatetimeOptional

updateslist of objectsOptional

disputedAmountobjectOptional

autoDebitStatusenumOptional

Allowed values:

autoDebitAmountCentsdoubleOptional

walletDebitTxHashstringOptional

walletCreditTxHashstringOptional

reversedbooleanOptional

decidedLostAtdatetimeOptional