Create Transaction Dispute

POST

https://api-sandbox.coinflow.cash/api/merchant/company-cards/cards/:rainCardId/transactions/:transactionId/disputes

POST

/api/merchant/company-cards/cards/:rainCardId/transactions/:transactionId/disputes

$ curl -X POST https://api-sandbox.coinflow.cash/api/merchant/company-cards/cards/rainCardId/transactions/transactionId/disputes \
>      -H "Authorization: <apiKey>" \
>      -H "Content-Type: application/json" \
>      -d '{}'

200Successful

1 {
2   "_id": "string",
3   "merchantId": "string",
4   "rainCompanyId": "string",
5   "transactionId": "string",
6   "disputeId": "string",
7   "status": "pending",
8   "disputeAmount": 1.1,
9   "hasFileEvidence": true,
10   "attachmentCount": 1.1,
11   "attachments": [
12     {
13       "rainAttachmentId": "string",
14       "fileName": "string",
15       "mimetype": "string",
16       "fileSizeBytes": 1.1,
17       "uploadedAt": "2024-01-15T09:30:00Z"
18     }
19   ],
20   "disputeCreatedAt": "2024-01-15T09:30:00Z",
21   "lastSyncedAt": "2024-01-15T09:30:00Z",
22   "createdAt": "2024-01-15T09:30:00Z",
23   "updatedAt": "2024-01-15T09:30:00Z",
24   "rainUserId": "string",
25   "rainCardId": "string",
26   "disputeType": "fraud",
27   "textEvidence": "string",
28   "resolvedAt": "2024-01-15T09:30:00Z"
29 }

File a dispute for a settled transaction on a card. One dispute per transaction; Rain rejects unsettled / zero-amount transactions with a 400.

Authentication

Authorizationstring

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

Path parameters

rainCardIdstringRequired

transactionIdstringRequired

Request

This endpoint expects an object.

disputeTypeenumOptional

textEvidencestringOptional

disputeAmountdoubleOptional

Response

_idstring

merchantIdstring

rainCompanyIdstring

transactionIdstring

disputeIdstring

statusenum

disputeAmountdouble

hasFileEvidenceboolean

attachmentCountdouble

attachmentslist of objects

disputeCreatedAtdatetime

lastSyncedAtdatetime

createdAtdatetime

updatedAtdatetime

rainUserIdstring

rainCardIdstring

disputeTypeenum

textEvidencestring

resolvedAtdatetime