BVbvnk
Fiat Payments

Confirm beneficiary's name

Confirms a payout when the beneficiary name check returns a mismatch warning. If not confirmed within five minutes, the action expires. In this case, make a new payout.

post/payment/v2/payouts/{id}/actions

Request

Path parameters

idstring uuid required
Example:3fa85f64-5717-4562-b3fc-2c963f66afa6

The payout transaction identifier returned by POST /payment/v2/payouts.

Request body

type'CONFIRM_BENEFICIARY' required

Action to confirm proceeding with the payout despite beneficiary name mismatch.

Response

Confirmation accepted; returns standard payout details.

idstring uuid required

Unique payout identifier.

method'SEPA_CT' | 'SEPA_INST' | 'FASTER_PAYMENT' | 'BACS' | 'TARGET2' | 'TIPS' | 'SWIFT' | 'ACH' | 'ACH_SAME_DAY' | 'FEDWIRE' | 'FEDNOW' | 'RTP' | 'BOOK' | 'UNKNOWN' | 'BANK_TRANSFER' | 'WIRE' | 'SEPA' required

Payment method used in the transaction. Note: This list can be changed in the future.

referencestring

Free text reference provided during payout creation (used mostly for reconciliation reasons).

status'PENDING' | 'PROCESSING' | 'PENDING_APPROVAL' | 'ON_HOLD' | 'COMPLETED' | 'EXPIRED' | 'CANCELLED' | 'FAILED' | 'RETURNED' required

Current payout status:

  • PENDING_APPROVAL: Payouts from the wallet require approval. The payout stays in this status until all approvals are received, then moves to PROCESSING. Only relevant for fiat payouts.

  • PROCESSING: Waiting for a final response from BVNK's processing partners.

  • ON_HOLD: Screening is taking longer than anticipated.

  • COMPLETED: The payout is complete on BVNK's side. The beneficiary bank may still reject the funds.

  • FAILED: The processing partners couldn't complete the payout. The funds remain in your wallet.

  • CANCELLED: The payout was cancelled, for example because a four-eyes approval was rejected or timed out. The funds are returned to your wallet.

  • RETURNED: The funds came back after the processing partners responded. The funds are returned to your wallet.

metadataMetadata required

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.

createdAtstring date-time required

Creation timestamp.

updatedAtstring date-time required

Last update timestamp.

type'payment:payout:fiat' required

Payment type constant.

direction'OUT' required

Payment direction constant.

Example response

{
  "fees": {
    "customerFee": {
      "amount": 100.5,
      "currency": "USD"
    },
    "processingFee": {
      "amount": 100.5,
      "currency": "USD"
    }
  },
  "originator": {
    "entity": {
      "dateOfBirth": "15-01-1990",
      "address": {
        "addressLine1": "123 Main St",
        "addressLine2": "Apt 4B",
        "region": "CA",
        "city": "Los Angeles",
        "country": "US",
        "postCode": "90001"
      }
    }
  },
  "beneficiary": {
    "entity": {
      "dateOfBirth": "15-01-1990",
      "address": {
        "addressLine1": "123 Main St",
        "addressLine2": "Apt 4B",
        "region": "CA",
        "city": "Los Angeles",
        "country": "US",
        "postCode": "90001"
      }
    },
    "bankAccount": {
      "bank": {
        "address": {
          "addressLine1": "123 Bank St",
          "addressLine2": "Suite 100",
          "region": "NY",
          "city": "New York",
          "country": "US",
          "postCode": "10001"
        }
      },
      "intermediaryBanks": [
        {
          "address": {
            "addressLine1": "123 Bank St",
            "addressLine2": "Suite 100",
            "region": "NY",
            "city": "New York",
            "country": "US",
            "postCode": "10001"
          }
        }
      ]
    }
  },
  "metadata": {
    "source": "api",
    "orderId": "ORD-48213"
  },
  "trackingDetails": [
    {
      "externalTransactionId": "123e4567-e89b-12d3-a456-426614174000",
      "imad": "20260304ABCDXXXX012345",
      "omad": "20260304QMQP021000080",
      "traceNumber": "021000080123456",
      "uetr": "550e8400-e29b-41d4-a716-446655440000"
    }
  ]
}

Changes

No recorded changes to this operation across all 3 revisions of this API.