Fiat Payments

List payment rules by wallet

Changed on Jun 16, 2026

Retrieves a list of payment rules applied to a specific wallet by its ID.

get/payment/v1/rules/{walletId}

Request

Base URL
https://api.sandbox.bvnk.com
Auth
HTTP bearer
TypeScript
https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/docs/payment/v1/rules/:walletId/get.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

walletIdstring required

Example:acc:22041242429000:3MPpU:0

BVNK wallet ID to filter payment rules.

Response

idstring uuid

Unique identifier for the payment rule. You can use this value to update the rule via `/payment/v1/rules/{id}.

referencestring

triggerstring

statusstring

Rule status. ACTIVE while the rule applies to incoming pay-ins on the wallet.

metadataMetadata

Custom metadata key-value pairs. Structure: key: value. Restrictions:

Maximum five keys.
Each key maximum length 50 characters.
Each value maximum length 100 characters.
Keys and values must be simple strings.

updatedAtstring date-time

createdAtstring date-time

Example response

[
  {
    "id": "98c0bb03-567f-11f0-b26e-6b1848874a27",
    "reference": "REF558628",
    "trigger": "payment:payin:fiat",
    "status": "ACTIVE",
    "fees": {
      "customerFee": {
        "amount": 0.5,
        "currency": "USD"
      }
    },
    "originator": {
      "currency": "USD",
      "walletId": "acc:22041242429000:3MPpU:0"
    },
    "beneficiary": {
      "currency": "USDT",
      "entity": {
        "legalName": "3Com",
        "type": "COMPANY",
        "relationshipType": "SELF_OWNED",
        "registrationNumber": "ABC21D21FZC",
        "address": {
          "addressLine1": "123 Main St",
          "addressLine2": "Some address Line 2",
          "city": "New York",
          "region": "NY",
          "postCode": "10001",
          "country": "US"
        }
      },
      "cryptoAddresses": {
        "network": "ETHEREUM",
        "addresses": [
          "0x12323542636474747"
        ],
        "tag": "332455"
      }
    },
    "metadata": {
      "source": "api",
      "orderId": "ORD-48213"
    },
    "updatedAt": "2025-07-01T13:31:02.52Z",
    "createdAt": "2025-07-01T13:30:02.52Z"
  }
]

Changes

Jun 16, 202697d6c0d2fe2e Revision changes
- breaking
  the / response's property type changed from object to array for status
- breaking
  the / response's property type changed from object to array for status
- breaking
  the / response's property type changed from object to array for status
- breaking
  the / response's property type changed from object to array for status
- warning
  removed the optional property // from the response with the status
- warning
  removed the optional property // from the response with the status
- warning
  removed the optional property // from the response with the status
- warning
  removed the optional property // from the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status

Operation history