swifood-ph-zh
选择语言
选择语言
  • English
  • 简体中文
选择语言
选择语言
  • English
  • 简体中文
    • Open API Code 提示码列表
    • 接口参数签名流程
    • 订单
      • 创建订单(通用)
        POST
      • 订单退款(通用)
        POST
      • 订单补打
        POST
      • 税费试算
        POST
      • 餐饮订单查询
        POST
      • 查询订单发票
        POST
    • 餐厅
      • 餐厅列表查询
        POST
    • 订单回调
      • 餐饮订单推送回调
        POST
    • 数据模型
      • SignedAppRequest
      • SignedStoreRequest
      • ApiError
      • BooleanResponse
      • ProductInput
      • CreateOrderParam
      • CreateOrderData
      • CreateOrderResponse
      • RefundParam
      • PrintParam
      • TaxCalculateParam
      • TaxItem
      • TaxResponse
      • OrderListParam
      • OptionItem
      • OrderOption
      • OrderSku
      • OrderData
      • OrderListResponse
      • OrderPushParam
      • InvoiceParam
      • InvoiceJson
      • Restaurant
      • RestaurantListResponse

    接口参数签名流程

    内容#

    参数名是否必填类型长度示例说明
    appId是string-45eebd745dcf0b5f6d6f9fcde28cd9fe8116a892应用 id (Swifood 提供)
    storeKey是string100CVIEIYUNHTS0店铺标识 (Swifood 提供)
    param是string--请求参数字符串
    sign是string-param 的RSA签名

    示例#

    {
      "appId": "45eebd745dcf0b5f6d6f9fcde28cd9fe8116a892",
      "storeKey": "CVIEIYUNHTS0",
      "sign": "abcdef",
      "param": "{}"
    }

    说明#

    1.
    appId 是由 Swifood 提供的固定值;
    2.
    根据具体接口文档,构造请求参数,将请求参数格式化为 JSON 格式,作为 param 的值;
    3.
    使用 RSA 私钥对 param 进行签名,得到的值作为 sign 的值。

    附录 RSA 使用示例(Java 语言)#

    生成RSA密钥对:
    RSA 公钥请提交给 Swifood,请不要透露给任何第三方。
    RSA 私钥由商户保管,请不要透露给任何人。
    当商户请求 Swifood 的 Open API 时,商户使用 RSA 私钥对请求参数进行签名,PayCools 会使用商户提供的 RSA 公钥对请求中的签名进行验证。如果验证失败,PayCools 服务器会拒绝处理请求。

    示例密钥对#

    RSA 公钥:
    MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAna4Dyz8nGJiAlc9jTGyRa+TtlZXYABTc+Xfb3T4NdDbnUO8vtNLHugwmqARp8kzEzsMRbmvKro4EpaXqANn7SAGo+YI6sVUDmX7ESk3P6j51PtTvWR6dikJN6qwtmV64ojEbxDnIBL3VKuctefL8uPcI7MZBUPBXg9l8CZmnn2cKqWjZ8MuEQr4G45IqmJ0tRsRmW9ofNnvI1MLPt7c/Z/D1E6HKVwjPcMZKMuF0HpIDqdQaPX83dlSzv9FF9jFR8HWfWW8Oz3jz+GtSLSdh2ERcyO56WHpWl1POV4o9jF+4R/oBgcH+0zA1Z2aFfQf/n9miMhacrioStBaHkh1f/QIDAQAB
    RSA 私钥:
    MIIEvgIBADANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIBAQCdrgPLPycYmICVz2NMbJFr5O2VldgAFNz5d9vdPg10NudQ7y+00se6DCaoBGnyTMTOwxFua8qujgSlpeoA2ftIAaj5gjqxVQOZfsRKTc/qPnU+1O9ZHp2KQk3qrC2ZXriiMRvEOcgEvdUq5y158vy49wjsxkFQ8FeD2XwJmaefZwqpaNnwy4RCvgbjkiqYnS1GxGZb2h82e8jUws+3tz9n8PUTocpXCM9wxkoy4XQekgOp1Bo9fzd2VLO/0UX2MVHwdZ9Zbw7PePP4a1ItJ2HYRFzI7npYelaXU85Xij2MX7hH+gGBwf7TMDVnZoV9B/+f2aIyFpyuKhK0FoeSHV/9AgMBAAECggEAYyqq5iucqgJXdGCO4eSx/LpolZg81ahJZXf1RgqdqYZSKnuTdFTQGflEYo0MGMAhUqwqDVkrimZ1E7zqE4kEWT/6BpnZ0edWsTWhu91+MqL/V/nRYio4CFk06a9JqliBJDhgbyOr4ReGtknYNwcT3Dw5V7hEIeRWFe007lC9tCi7mlpzBNwEIf4itmnncuA70GlxcoMkoGzfYg79eUCfXorbfJcaamR2wXLSU6KoJ422UR3L0rgzmgXzVQw9rrlQ3h6viDykKfaPi/43MN2qb6Zu5isbJIzyz0kHrcE6KJMgJhBDkLIo0f0qE/rEl1Xp/qDwr4+3WBfCHeuTFsud/QKBgQDXmA3f0/ONPMgEGdJlwG20W+7jXHabnRPuUJyDQKbtP+vuaKrpzN+jC1rlxBfAJj2iAVXXXM/RFWWapBd16TqGI4P3RW8eocaxhyl8rWSvCOy/OueNI+fM8gX/IjsJc7VMmCEWHuLvXoM2ixXPWP3v0DEPPPDrCd5dnjR6+5oGgwKBgQC7O03ps4KzMUzEtJcrFFKV0C/m1X905OqQ3cKQnGqRzLp/7d9DQsv+oKzjlpz1xktdJmig7ABiL0+FqJHdcrNiVabI5c6oS2SZkToQFlKv2GYT2KikJ0L43xLfiDvB3tues//9OXuU0WzXZqq7CNAvcmAdPjlFi9RxHsRGABo3fwKBgEi2EJ/XpQGSaUbwyoPktVsp0lS9/4aWIH20lES0DlhfwZuDk3kMzrP3hW2OiBAXFZxI5QGgXLqAg+b2xq7OvR02ZzCDK2niV9fR5Q0Wkaly0h3gqO1yGaCGU71rdwvGCXROroH+Yr0mXAyONgnbUrGJvrIL9JjgmC1syPhdWOIvAoGBAJHJbbNpWX3aB2KrE4IxwtRwVLwyxZnpnVPLuPINOVXpydZPDCc9XcYYqkZUQkeFba1MeO/Ek8/f8tWqGloKM+9/reyENFQK0Hxa/pEEMMJHh8QwUa/v+k/6sqFnXNBqjSuYEN3F4ppQL6XRhWM5S5GGR5y9lK64YGTshfvTnJZVAoGBAJ3TmJcRJWfi7CA985VAnE+IQoQfKKz9NTT7hGBwWTVd7iUc0QCpgHNIixZnfVcjKxz7Hhq6Vy+cEbDBtwbSuDfuVf1spiiqOuYVIjFqq5AsuvpX1CJmm7V+LRtJO/NXmXQP5YfojzET9NqTZvGEVXuzPA0qp8JC7HKrCYykscqE

    RSA 签名:#

    sign 的值:
    Leh6eu60as3iiiWJiimZxZv9SKKBxyGUUoaHW0K3qZp8p4I6eyCTa4KkcZHFwE7lF16oOz5InSwDOGLAix+EMOqT8bZb/w+jzC0xGp9xdgLKEPm6woinauimyBBwvHfEydnFhrOX240XgMwMH5av9VyUIyngYslcn7PhY6zvyaQr1MYEmpkMit5m1o7iWd7sBgeXWixxCXtrKMbrG2TLepZnymk+t+nh+nR4sH66gD+uXPSq0/SzrgbChuDcdr8ybdtLOuXKX4FdM2WnvzmgSncJrU9RyRUzu6EKzCutfsYaNkV8ii70Tkabc4p4HRzaotCJ7kHyuHBPL6k0sncZrg==

    RSA 签名验证#

    result 的值: true

    UAT环境订单推送回调接口签名验证密钥#

    RSA 公钥请不要透露给任何第三方。
    RSA 私钥由Swifood保管。
    当 Swifood 向其他系统推送订单信息时,商户使用以上 RSA 公钥对请求参数进行签名验证,如果验证失败,商户服务器应该拒绝处理请求。
    RSA 公钥:
    MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAmkKwnkwoAGpEalUbM6TPg4ECcZBf2FYKst5gVQPrShYE6Wt4kmLsCVdHM0qoIr6TSiz0qhPwmhw898ZfzJdHPqckWka+4sUewYtxBOYC4a0Z8JYtQgTRxoK8Vvo9sXjW2pILrd0ZcB6QuHHzGC4AXjA1dB88mvsoNFi03eIhlCxFJ4fn0xA+1+359iTFymi+vTUmD6/OmphVAdTL9BYCq5NkzsoAsTmz+eF5xqkZlZ9vFhSikHN/Q/hpAW86hIs+Fq1b98ICGDRQZLrEH9E2/MB9VIzo4/U9jIf+0DPCALY8/WZJc1WXIBaDHBBVCq6xjM6JrBsF74jy01DBIP/C9wIDAQAB
    修改于 2026-10-26 02:42:16
    上一页
    Open API Code 提示码列表
    下一页
    创建订单(通用)
    Built with