SoftBank Matomete Shiharai

Features
Method	Async - POST Redirect
Merchant countries	Hong Kong
Consumer Countries	Japan
Processing currencies	JPY
Increments	-
Captures	✅
Partial captures	✅
Multiple partial captures	-
Cancels	✅
Partial/Multiple partial cancels	-
Refunds	✅
Partial/Multiple partial refunds	-
Recurring	-
Installments	-
Credits	-
Disputes	-
Min Amount	1
Account verification	-

SoftBank Matomete Shiharai is a carrier billing payment service that enables consumers with eligible SoftBank accounts in Japan to complete purchases using a consolidated carrier payment flow. The payer is redirected to the carrier environment to authenticate and confirm the transaction before returning to the merchant.

Payment flow

Payment

Request

{
  "processingAccountId": "2HdN2jq6XWmlkhqRC2gDTNYCvNH",
  "merchantReference": "c5211d6b-0178-49f8-a06b-69df097a712f",
  "amount": {
    "value": 200,
    "currency": "jpy"
  },
  "paymentMethod": {
    "type": "softbank_matomete_shiharai",
    "softbankMatometeShiharai": {
      "returnUrl": "https://merchant.site/complete-payment"
    }
  }
}

Response

{
  "id": "27yiW9MgzBtwiodreuNOXk0rtIw",
  "merchantReference": "c5211d6b-0178-49f8-a06b-69df097a712f",
  "status": "pending",
  "trackingUrl": "/v1/tracks/payments/{trackId}",
  "reason": {
    "code": "required_next_step",
    "description": "An additional step is needed to complete the payment."
  },
  "nextStep": {
    "type": "redirect",
    "redirect": {
      "method": "post",
      "url": "https://payment.method/complete",
      "params": [
        { "name": "pay_method", "value": "carrier" },
        { "name": "merchant_id", "value": "99999" },
        { "name": "service_id", "value": "000" },
        { "name": "cust_code", "value": "27yiW9MgzBtwiodreuNOXk0rtIw" },
        { "name": "order_id", "value": "27yiW9MgzBtwiodreuNOXk0rtIw" },
        { "name": "item_id", "value": "27yiW9MgzBtwiodreuNOXk0rtIw" },
        { "name": "amount", "value": "200" },
        { "name": "pay_type", "value": "0" },
        { "name": "service_type", "value": "0" },
        { "name": "success_url", "value": "https://merchant.site/complete-payment" },
        { "name": "cancel_url", "value": "https://merchant.site/complete-payment" },
        { "name": "error_url", "value": "https://merchant.site/complete-payment" },
        { "name": "pagecon_url", "value": "https://merchant.site/complete-payment" },
        { "name": "request_date", "value": "20251113004457" },
        { "name": "limit_second", "value": "600" },
        { "name": "sps_hashcode", "value": "925A6E17DC937C3C1D277BADE05322DBXXXXXXXX" }
      ]
    }
  }
}