cURL

Wave B2B Recipient Info API (upcoming)

ENDPOINTS:

GET /v1/b2b/recipient-info

API

Getting information on a merchant or business

Sometimes you might want to fetch information about a B2B recipient.

Wave B2B recipients agree to share simple account name information with B2B senders. Keep in mind that we are only returning the name of the account as registered with Wave, so the name of the legal entity might be different.

GET /v1/b2b/recipient-info

curl --request GET \
  --url https://api.wave.com/v1/b2b/recipient-info?mqr=0EFyTKqG \
  -H 'Authorization: Bearer wave_sn_prod_YhUNb9d...i4bA6' \

or

curl -X GET \
  --url https://api.wave.com/v1/b2b/recipient-info?account_number=SN12233445 \
  -H 'Authorization: Bearer wave_sn_prod_YhUNb9d...i4bA6'

Example response

{
    "name": "Cashew Inc.",
    "account_number": "SN 12 23 34 45",
    "m_id": "M_ABCxyz123"
}

URL Parameters

Key Type Description
account_number String (optional) The current merchant recipient ID that's used in sending and receiving B2B payments. You can pass this with or without whitespace, though the whitespace will need to be escaped in the URL parameter.
mqr String (optional) A merchant physical QR code that can be found in many stores. These codes are assigned to merchants on a case-by case basis, but will never get reassigned.
m_id String (optional) The deprecated, less user-friendly, merchant recipient ID that can be used in sending and receiving B2B payments.

Getting merchant information from a QR code

Retrieve merchant details by decoding Wave QR code content. Use this to identify a B2B recipient before initiating a payment.

Supported QR code formats:

POST /v1/b2b/recipient-info-from-qr

curl --request POST \
  --url https://api.wave.com/v1/b2b/recipient-info-from-qr \
  -H 'Authorization: Bearer wave_sn_prod_YhUNb9d...i4bA6' \
  -H 'Content-Type: application/json' \
  -d '{"qr_content": "https://pay.wave.com/mqr/0EFyTKqG"}'

Request body

Field Type Required Description
qr_content string Yes The raw string obtained from scanning the QR code.

Response (200 OK)

{
    "name": "Cashew Inc.",
    "m_id": "M_ABCxyz123",
    "account_number": "SN 12 23 34 45"
}
Field Type Description
name string The merchant's registered business name.
m_id string Opaque merchant identifier. Use this when initiating payments.
account_number string The merchant's formatted account number.

Error responses

404 Not Found — No active merchant matches the QR code content.

{
    "error": "No merchant found for this QR code"
}

This can occur when: