Skip to main content
​
May 2026
Added
Multicaixa Express payments now return a multicaixaExpress object in the payment response, containing QR code and deeplink data to support the full checkout experience across desktop and mobile.When brand is MULTICAIXAEXPRESS, the response includes:
FieldTypeDescription
deeplinkstring (uri)Direct deeplink to open the Multicaixa Express app.
deeplinkRedirectstring (uri)Redirect URL for browser and mobile flows to the app.
qrCodeUrlstring (uri)URL of the QR code image.
expiresAtstring (ISO 8601)Payment expiration timestamp.
{
  "multicaixaExpress": {
    "deeplink": "mcxwallet://purchase?qrref=...",
    "deeplinkRedirect": "https://api.sandbox.proxypay.co.ao/deeplink/...",
    "qrCodeUrl": "https://api.sandbox.proxypay.co.ao/qrcode/...",
    "expiresAt": "2026-05-22T19:14:04Z"
  }
}
On desktop, Paybyrd Checkout uses qrCodeUrl to display a QR code for the buyer to scan. On mobile, tapping Pay uses deeplinkRedirect to open the Multicaixa Express app directly.See the Multicaixa Express guide for full details.
​
April 2026
Added

​
New field: softDescriptor for card payments

Card payments now support a softDescriptor field, which controls the text that appears on the cardholder’s bank statement for that transaction.
  • Maximum length: 22 characters
  • Requests exceeding this limit return a 400 Bad Request error
curl --request POST \
 --url https://gateway.paybyrd.com/api/v2/payment \
 --header 'Accept: application/json' \
 --header 'Content-Type: application/json' \
 --header 'x-api-key: {your_api_key}' \
 --data '{
   "softDescriptor": "MYSTORE*ORDER123",
   ...
 }'
See the card payments guide and the Create Payment API reference for full details.