Question About Monthly Recurring Payments Using Square APIs in Japan

Hello Square Developer Support Team,

I am a merchant based in Japan, building a membership service called SKY FRIENDS for our dog-run business.

We would like to implement monthly recurring payments using Square APIs.

Our planned subscription plans are:

  • JPY 300/month: Notifications when dogs of the same breed visit our facility.

  • JPY 500/month: Same-breed notifications plus notifications when favorite dogs visit.

Our intended payment flow is:

  1. Customers register their email address in our web application.

  2. Customers securely enter their credit card details using Square Web Payments SDK.

  3. The card is securely saved using the Square Cards API.

  4. Monthly recurring payments are automatically charged using the saved card.

  5. Customers can change their subscription plan, with the new price taking effect from the next billing date.

  6. Customers can cancel their subscription.

We use a Japanese Square account and are currently testing in the Sandbox environment.

Could you please clarify the following?

  1. Are the Cards API and Subscriptions API supported for Japanese Square accounts?

  2. Can a card saved using the Cards API be used for monthly recurring payments through the Subscriptions API in Japan?

  3. Are fixed monthly fees for a digital membership service, such as JPY 300 and JPY 500, supported?

  4. Can subscription plan changes be scheduled to take effect on the next billing date?

  5. Are there any additional requirements regarding 3D Secure authentication or recurring payments in Japan?

We would appreciate your guidance on the recommended API implementation for Japanese merchants.

Thank you for your help.

Yes, Cards API and Subscriptions API can be used with Japanese Square accounts. Your production account must be enabled for card processing.

For SKY FRIENDS, the API flow would be:

  • Save the card: Create a Square customer profile with the customer’s email, collect their permission to save the card, and use the Web Payments SDK and Cards API. Supply the saved card_id and associated customer_id when creating the subscription. Square then handles scheduled billing.
  • ¥300/¥500 monthly memberships: Use two subscription plan variations with MONTHLY cadence and STATIC pricing in JPY. Static pricing supports flat-fee services and doesn’t require order templates. Plans and pricing
  • Plan changes: Use SwapPlan to schedule the new variation for the next billing period. Plan swaps
  • Cancellation: CancelSubscription schedules cancellation at the end of the current billing cycle. Cancellation guidance
  • 3D Secure: Implement buyer verification for buyer-initiated online card payments in Japan. When saving a card without charging it, follow the documented intent: "STORE" flow. Seller-initiated recurring charges do not require SCA. Authentication guidance

One testing caveat: Sandbox does not reliably reproduce the complete subscription billing lifecycle, so validate renewals with a controlled, low-value production test before launch. Sandbox clarification