Request a physical card for delivery

Request a physical card for a customer who currently has only a virtual card. The physical card will be manufactured and mailed to the provided delivery address.

The entityId and kitNo fields are explicitly validated by the backend. If requesting physical delivery, provide a complete delivery address in the addressDto.

The virtual card remains active until the physical card is activated by the customer. The same kitNo is used for both the virtual and physical card.

Address field constraints - Each address line (address1, address2, address3) allows maximum 35 characters, alphanumeric with spaces. City accepts only alphabetic characters without spaces. State accepts alphabetic characters with spaces. Postal code is 6 digits for India. The aliasName field (max 30 characters) is printed on the physical card.

Address formation for card printing - Version 1 (Indian card printers) - Each field max 35 chars. If any field exceeds limit, first 140 chars of address1 + address2 + city, plus first 35 chars of state. Version 2 (Non-Indian card printers) - Total 175 characters with tilde separator for line breaks, includes address1, address2, address3, city, state, country.

curl -X POST "https://api.m2p.com/Yappay/business-entity-manager/requestPhysicalCard" \  -H "Content-Type: application/json" \  -d '{    "entityId": "123456789012",    "kitNo": "1234567890",    "addressDto": {      "address": [        {          "title": "DELIVERY",          "address1": "address1",          "address2": "address2",          "address3": "address3",          "fourthLine": "address4",          "city": "deliverycity",          "state": "deliverystate",          "country": "deliverycountry",          "pinCode": "123456",          "aliasName": "customer name"        }      ]    }  }'

{
  "result": true,
  "exception": null,
  "pagination": null
}

{
  "result": null,
  "exception": {
    "detailMessage": "Customer Id should not be empty",
    "shortMessage": "Empty EntityId",
    "errorCode": "Y1001",
    "languageCode": "en"
  },
  "pagination": null
}