---
title: "CreateOrderRecipient"
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.cardzone.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# CreateOrderRecipient

Path: Cardzone B2B API

For voucher products, name/email/mobile are optional delivery details. For top-ups, send every canonical key advertised in recipient_fields by the catalog. PUBG normally requires player_id; Mobile Legends requires player_id and zone_id. Other products may require region_id or arbitrary configured safe keys. Send values as nonblank strings to preserve leading zeros. Missing and unconfigured fields return 422 validation_failed before order creation or fulfillment. Never substitute provider-specific keys such as userId or account_id unless that exact canonical key is configured on the Product.

## Fields

- `name` (`CreateOrderRecipient.name`; string, optional)
  - example `"Customer Name"`
- `email` (`CreateOrderRecipient.email`; string, optional)
  - format `email`
- `mobile` (`CreateOrderRecipient.mobile`; string, optional)
  - example `"+966500000000"`
- `player_id` (`CreateOrderRecipient.player_id`; string, optional)
  - example `"123456789"`
- `zone_id` (`CreateOrderRecipient.zone_id`; string, optional)
  - example `"1234"`
- `server_id` (`CreateOrderRecipient.server_id`; string, optional)
  - example `"5678"`
- `region_id` (`CreateOrderRecipient.region_id`; string, optional)
  - example `"eu"`
- `account_tag` (`CreateOrderRecipient.account_tag`; string, optional)
  - example `"main"`


Source: https://docs.cardzone.ai/reference/schemas/CreateOrderRecipient/index.md