> ## Documentation Index > Fetch the complete documentation index at: https://waffo.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # 创建 VCC 卡片 ## OpenAPI ````yaml /api-reference/openapi.json post /api/v1/issuing/cards/create openapi: 3.1.0 info: title: acquiring-order description: 接口文档 termsOfService: https://www.waffo.com version: 1.0.0 servers: - url: https://waffo.com description: Sandbox API (auto-signed via waffo.com signing proxy) security: [] tags: - name: Subscription inquiry description: Subscription inquiry api description - name: Subscription manage description: > This API allows the merchant to request a subscription management URL from Waffo Waffo will generate a subscription management URL which merchant can redirect user to this URL for managing subscription details (e.g. view subscription detail and cancel subscription). This management URL has a fixed expiration time (e.g., 1 day). - name: Subscription change inquiry description: > This API allows merchants to query the status of a subscription change (upgrade/downgrade) request. 此接口允许商户查询订阅升降级请求的状态。 - name: Subscription resume description: > Revoke a scheduled cancellation before it takes effect, so that the subscription keeps renewing. The next billing date stays unchanged. - name: Subscription update description: ' Subscription update api description' - name: Payment session update description: Payment session update api description - name: Order inquiry description: Order inquiry api description - name: Payout inquiry description: Payout inquiry api description - name: Order create description: ' Order create api description' - name: Pay Method Config Inquiry description: Pay Method Config Inquiry api description - name: Payment session create description: Payment session create api description - name: Order cancel description: Order cancel api description - name: Order capture description: Order capture api description - name: Subscription session create description: Subscription session create api description - name: Chargeback list description: Chargeback list api description - name: Payout create description: Payout create api description - name: Subscription session update description: Subscription session update api description - name: Payment session confirm description: Payment session confirm api description - name: Payment session validate description: Payment session validate api description - name: Payment session info description: Payment session info api description - name: Chargeback file download description: Chargeback file download api description - name: Subscription change description: > This API allows merchants to upgrade or downgrade a user's subscription plan. The change request will create a new subscription based on the original subscription, applying any remaining amount from the original subscription. 此接口允许商户升级或降级用户的订阅计划。升降级请求将基于原订阅创建新订阅，并将原订阅的剩余金额应用到新订阅中。 - name: Chargeback accept description: Chargeback accept api description - name: Chargeback file upload description: Chargeback file upload api description - name: Chargeback update description: Chargeback update api description - name: Wallet inquiry description: Wallet inquiry api description - name: Order refund description: Order refund api description - name: Refund inquiry description: Refund inquiry api description - name: Subscription cancel description: > Cancel an active subscription when the merchant no longer wishes to continue the recurring billing cycle. This endpoint can only be invoked when the subscription status is active - name: Merchant config inquiry description: Merchant config inquiry api description - name: Chargeback inquiry description: Chargeback inquiry api description - name: Subscription create description: Subscription create api description - name: Reported Fraud list description: Reported Fraud list api description paths: /api/v1/issuing/cards/create: post: tags: - VCC issuing summary: 创建 VCC 卡片 operationId: createCard requestBody: content: application/json: schema: $ref: '#/components/schemas/ExternalCardCreateRequest' required: true responses: '200': description: OK content: '*/*': schema: $ref: '#/components/schemas/ResponseExternalCardData' components: schemas: ExternalCardCreateRequest: type: object description: 对外-开卡请求 properties: idempotentId: type: string description: 开卡业务键, 1~64 位字母数字下划线横线 minLength: 1 pattern: ^[A-Za-z0-9_-]{1,64}$ accountAgreementId: type: string description: 所属账户标识 minLength: 1 cardProduct: type: string description: 对外卡产品码 publicCode, 选填; 不传取账户默认 currency: type: string description: 卡限额币种, 须等于账户币种 maxLength: 16 minLength: 0 customFirstName: type: string description: 持卡人名, 最长 64 maxLength: 64 minLength: 0 customLastName: type: string description: 持卡人姓, 最长 64 maxLength: 64 minLength: 0 monthlyLimitAmount: type: string description: 月限额金额字符串 minLength: 1 pattern: ^\d{1,12}(\.\d{1,2})?$ dailyLimitAmount: type: string description: 日限额金额字符串, 选填; 不传即不设日限额 pattern: ^\d{1,12}(\.\d{1,2})?$ transactionLimitAmount: type: string description: 单笔限额金额字符串 minLength: 1 pattern: ^\d{1,12}(\.\d{1,2})?$ validityPeriodMonths: type: integer format: int32 description: 有效期月数 3/6/9/12/18/24/30/36, 选填; 不传取服务端默认 required: - accountAgreementId - currency - customFirstName - customLastName - idempotentId - monthlyLimitAmount - transactionLimitAmount ResponseExternalCardData: type: object description: response data properties: code: type: string example: 0 msg: type: string example: success data: $ref: '#/components/schemas/ExternalCardData' ExternalCardData: type: object description: 对外-卡 properties: cardId: type: string description: 卡号(我方 cardId) accountAgreementId: type: string description: 所属账户标识 panLast4: type: string description: 卡号后四位, 卡数据准备中为 null cardScheme: type: string description: 卡组织 cardProduct: type: string description: 对外卡产品码, 反查不到为 null customFirstName: type: string description: 持卡人名 customLastName: type: string description: 持卡人姓 status: type: string description: 展示态 limitReachedReason: type: string description: MONTHLY / DAILY currency: type: string description: 限额币种 monthlyLimitAmount: type: string description: 月限额 dailyLimitAmount: type: string description: 日限额 transactionLimitAmount: type: string description: 单笔限额 createTime: type: string description: 卡记录创建时间 issuingTime: type: string description: 发卡时间 expiryTime: type: string description: 卡到期时间 ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.