Generate Card | Shimi API

Issues a physical Verve card for a customer already registered via Create Card Customer.

Body (JSON) — both required (presence check only):

Field	Type	Notes
`customerId`	string	Customer already registered via Create Card Customer
`number`	string	Identifier of the physical card being assigned; forwarded to the provider as `cardReference`

Always issues a PHYSICAL, Verve, NGN card with status active (these cannot be chosen). Returns 201. Save data.cardId — it is the cardId used by every other card endpoint. Provider errors are returned verbatim as Sudo API Error: <httpStatus> - <provider JSON>.

All errors from this folder use { "status": "error", "message": "..." } and are returned as HTTP 400 (including “Card not found” — there is no 404). Success bodies use status: "success" (not success: true like the VTU endpoints).

Authentication

AuthorizationBearer

Access token from Generate Access Token (valid 15 minutes).

Request

This endpoint expects an object.

customerIdstringOptional

numberstringOptional

Response

Created

statusstringOptional

messagestringOptional

dataobjectOptional

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error