Dashboard

Vendor Invoices & Transactions

Get Vendor Invoices

Retrieve all invoices associated with a vendor account - API Reference

GET https://api.dev.mrkter.io/vendor/invoice

Example response:

{
  "hasMore": true,
  "totalCount": 100,
  "totalPaymentAmount": {
    "currency": "USD",
    "amount": 1000
  },
  "filters": [
    {
      "statuses": [
        "PARSING",
        "DRAFT"
      ]
    }
  ],
  "items": [
    {
      "id": 123,
      "accountId": 123,
      "createdAt": "2025-04-03T10:23:07.211Z",
      "updatedAt": "2025-04-03T10:23:07.211Z",
      "type": "CONNECTOR",
      "uniqueId": "1234567890",
      "paymentRange": "string",
      "country": "US",
      "invoiceFileType": "string",
      "invoiceURL": "string",
      "invoiceLocalURL": "string",
      "originalInvoiceURL": "string",
      "originalInvoiceFileType": "string",
      "details": "string",
      "comments": "string",
      "affiliateId": "string",
      "VATApplied": "string",
      "VATRate": "string",
      "paymentType": "string",
      "invoiceDetails": {},
      "invoiceAmount": 0,
      "invoiceCurrency": "string",
      "VATEnable": true,
      "VATAppliedType": "string",
      "VATValue": 0,
      "VATAmount": 0,
      "TAXEnable": true,
      "TAXValue": 0,
      "TAXAmount": 0,
      "invoiceNetTotal": 0,
      "commissionAmount": 0,
      "commissionCurrency": "string",
      "commissionPaidBy": "string",
      "lastStatusChange": "string",
      "statusChangedBy": "string",
      "adminComment": "string",
      "requestCommissionsStartDate": "string",
      "requestCommissionsEndDate": "string",
      "affiliateEmail": "string",
      "bankBranch": "string",
      "bankCountry": "string",
      "bankCity": "string",
      "swiftCode": "string",
      "IBANNumber": "string",
      "ABANumber": "string",
      "bankCorrespondent": "string",
      "paypalReceiver": "string",
      "paypalRecipientType": "string",
      "payoneerId": "string",
      "payoneerUsername": "string",
      "affiliateManagerId": "string",
      "affiliateManager": "string",
      "paymentThreshold": "string",
      "VATNumber": "string",
      "VATPercentage": "string",
      "accountBeneficiary": "string",
      "accountNumber": "string",
      "bankName": "string",
      "connectorId": 123,
      "connector": {},
      "invoiceId": "string",
      "accountType": "string",
      "status": "string",
      "baseAmount": 0,
      "baseCurrency": "string",
      "sourceAmount": 0,
      "sourceCurrency": "string",
      "sourceRate": 0,
      "sourceLocked": true,
      "recipientAmount": 0,
      "recipientCurrency": "string",
      "recipientRate": 0,
      "recipientLocked": true,
      "cryptoCurrency": "BTC",
      "cryptoAmount": 0,
      "cryptoRate": 0,
      "firstName": "string",
      "lastName": "string",
      "companyName": "string",
      "cryptoWalletAddress": "string",
      "requestDate": {},
      "airwallexPaymentPayload": {},
      "cryptoPaymentPayload": {
        "walletAddress": "1Lbcfr7sAHTD9CgdQo3HTMTkV8LK4ZnX71",
        "cryptoCurrency": "BTC",
        "sourceCurrency": "USD",
        "amount": "0.1"
      },
      "identifier": "string",
      "vendorId": 123
    }
  ]
}

Get Vendor Transactions

Retrieve all transactions related to the vendor’s invoices and payouts - API Reference

GET https://api.dev.mrkter.io/vendor/transaction

Example response:

{
  "hasMore": true,
  "totalCount": 100,
  "filters": {
    "statuses": [
      "SETTLED"
    ],
    "types": [
      "Conversion"
    ],
    "currencies": [
      "EUR",
      "USD",
      "GBP"
    ]
  },
  "items": [
    {
      "userId": 128,
      "accountId": "189",
      "paymentId": "735889b2-9f49-4b4a-8cfa-755f4ed36e24",
      "invoiceId": 1234,
      "reference": "735889b2-9f49-4b4a-8cfa-755f4ed36e24",
      "requestId": "5c44b422-4371-439b-9ba1-277437284461",
      "amount": 100.1,
      "currency": "USD",
      "status": "PROCESSING",
      "paybisTransactionId": "PBQA2401152122TX19",
      "type": "Conversion",
      "details": "Conversion",
      "typeOfTransaction": "Type of transaction",
      "createdAt": "2021-07-14T06:09:39+0000",
      "updatedAt": "2021-07-14T06:09:39+0000",
      "valueDate": "2021-07-14T06:09:39+0000",
      "error": "Payment fail!",
      "cryptoTransaction": {
        "id": 12,
        "identifier": "128",
        "accountId": 189,
        "invoiceId": "1234",
        "fiatPaymentId": "735889b2-9f49-4b4a-8cfa-755f4ed36e24",
        "fiatPaymentDate": "2021-07-14T06:09:39+0000",
        "wallet": "tb1qm4lnjdevfnzjv0qwdcdyk8n96nrq4zwpujf750",
        "transactionHash": "5c44b422-4371-439b-9ba1-277437284461",
        "transactionId": "5c44b422-4371-439b-9ba1-277437284461",
        "amount": 100.1,
        "currency": "USD",
        "exchangeRate": 1.12,
        "cryptoAmount": 0.00001,
        "cryptoCurrency": "BTC",
        "status": "Conversion",
        "fiatCanceledPaymentDate": "2021-07-14T06:09:39+0000",
        "paybisReceivedWebhookData": "2021-07-14T06:09:39+0000",
        "createdAt": "2021-07-14T06:09:39+0000",
        "updatedAt": "2021-07-14T06:09:39+0000"
      },
      "beneficiaryName": "string"
    }
  ]
}