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' \

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

Sometimes you might want to fetch information about a B2B recipient from a physical Wave QR-code sticker, like the ones found in shops. This endpoint lets you simply pass the QR code content into

GET /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' \
  -d '{"qr_content": "https://pay.wave.com/mqr/0EFyTKqG"}'

Example response

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

JSON body Parameters

Key	Type	Description
`qr_content`	String	The raw string that you get when decoding the QR code.