Skip to main content
POST
/
disputes
curl --request POST \
  --url https://business.bfinance.app/external/api/disputes \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "cardId": "65f1c2a...",
  "transactionId": "txn_12345",
  "textEvidence": "I did not authorize this transaction. Merchant did not deliver goods.",
  "files": [
    "https://files.example.com/evidence1.png"
  ]
}
'
{
  "status": "success",
  "data": {
    "id": "<string>",
    "status": "pending",
    "textEvidence": "<string>",
    "files": [
      "<string>"
    ],
    "createdAt": "2023-11-07T05:31:56Z"
  }
}

Authorizations

Authorization
string
header
required

JWT authentication token

Body

application/json
cardId
string
required

Prepaid/budget card ID

transactionId
string
required

Transaction ID

textEvidence
string
required
Required string length: 10 - 65535
files
string[]

Optional file URLs attached as evidence

Response

Dispute created successfully.

status
string
Example:

"success"

data
object