请求礼品卡购买审批

requestGiftCardPurchase 提交经理审批请求以购买礼品卡。审批通过后，Fluz 会使用提交的参数完成购买。

Scopes

Action	Scope
创建请求	`REQUEST_GIFT_CARD`
列出请求	`LIST_APPROVALS`
批准或拒绝	`MANAGE_APPROVALS`

Webhook 标识符

Field	Value
`approvalType`	`GIFT_CARD`
`approvalCode`	`400007`

Webhook 事件：APPROVAL_CREATE、APPROVAL_APPROVE、APPROVAL_DECLINE，以及在执行失败时的 APPROVAL_HANDLER_ERROR。

创建请求

输入字段与直接的 purchaseGiftCard 变更相同。有关优惠与资金来源详情，参见购买礼品卡。

RequestGiftCardPurchaseInput

Field	Type	Required	Description
`offerId`	UUID	Yes	礼品卡优惠 ID
`purchaseAmount`	Float	Yes	购买金额
`channel`	SourcePlatformChannel	Yes	请求来源渠道（例如，`API`）
`fluzpayAmount`	Float	No	从 Fluz 余额出资的金额
`bankCardId`	UUID	No	银行卡资金来源
`bankAccountId`	UUID	No	银行账户资金来源
`paypalVaultId`	UUID	No	PayPal 资金来源
`userCashBalanceId`	UUID	No	用于出资的消费账户
`seatId`	UUID	No	与此次购买关联的席位
`exclusiveRateId`	UUID	No	专属费率 ID
`merchantSlug`	String	No	商户 slug
`gcWarehouseMerchantId`	UUID	No	礼品卡仓库商户 ID
`gcWarehouseUserRewardRate`	Float	No	仓库用户奖励费率
`gcWarehouseDiscountRate`	Float	No	仓库折扣率
`memo`	String	No	交易备注
`categoryId`	UUID	No	交易类别 ID

示例变更

mutation {
  requestGiftCardPurchase(
    input: {
      offerId: "ed669305-5e43-40a0-9a25-7a15ed174628"
      purchaseAmount: 25.00
      channel: API
      fluzpayAmount: 25.00
      userCashBalanceId: "b1155504-ad30-4b2f-873d-b8795277b128"
    }
  ) {
    success
    messageId
    error {
      code
      message
    }
  }
}

示例响应

{
  "data": {
    "requestGiftCardPurchase": {
      "success": true,
      "messageId": "1234567890"
    }
  }
}

批准请求

使用 approvalId 调用 approveApprovalRequest。需要 MANAGE_APPROVALS。

mutation {
  approveApprovalRequest(approvalId: "07df5653-43a8-4532-9881-3ab5857bbe12") {
    success
    approvalId
    action
  }
}

批准后，Fluz 会购买礼品卡。

拒绝请求

使用 approvalId 调用 declineApprovalRequest。需要 MANAGE_APPROVALS。

mutation {
  declineApprovalRequest(approvalId: "07df5653-43a8-4532-9881-3ab5857bbe12") {
    success
    approvalId
    action
  }
}

当请求被拒绝时，不会购买任何礼品卡。

​Scopes

​Webhook 标识符

​创建请求

​RequestGiftCardPurchaseInput

​示例变更

​示例响应

​批准请求

​拒绝请求