FAQ(For Creators)

codoc

What is codoc?

codoc is a service that allows you to monetize your articles by simply pasting a tag into your blog, enabling you to sell individual articles or offer subscriptions.

Monetize Articles by Simply Pasting a Tag

By adding codoc tags to your website, which runs on WordPress or other blog services, you can quickly introduce article distribution and a billing mechanism called a paywall.

Seamless Billing Flow for Article Subscriptions

A paywall is a system that monetizes content, displaying it to users who have paid for it. With a simple paywall that easily matches your site, your audience can enjoy subscriptions without being bothered by authentication, membership registration, or card payment procedures.

Turn Your Media into a Subscription Service

In addition to individual article sales, codoc also supports subscription sales. By managing your content with codoc's subscription system, you can easily build a membership site.

How to Sell Articles

After posting an article, simply paste the issued tag onto your site. First, you post the article on codoc. Article registration is done in the same way as a general blog system, but at that time, you also set the price and paid sections. Once the article post is complete, you can obtain a tag to paste, and by pasting that tag onto your site, the article you wrote on codoc will be displayed on your site with a paywall. codoc provides a plugin for WordPress to eliminate the hassle of pasting. Using this plugin makes it even easier to publish articles.

Fees

Free to Use codoc

codoc does not charge any listing fees, annual fees, or registration fees. There are no monthly usage fees for the system used by content distributors (creators).

10% of Sales as Transaction Fees

When an audience member purchases an article or subscribes to a subscription, a transaction fee is incurred from the sales. The fee is 10% of the sales, and the creators will receive the revenue after the fee is deducted from the sales.

Sales Revenue Transferred via Bank Transfer

Once sales revenue is generated, you can request a bank transfer after registering your bank account details on codoc. After the transfer request, you can expect the deposit within 4 to 30 business days.

Minimum Transfer Amount is 10 USD/EUR, Transfer Fee is 3 USD/EUR

You can request a transfer when your sales revenue reaches 10 USD/EUR or more. The transfer fee is 3 USD/EUR per transfer request. The transfer fee, along with the transaction fee, will be deducted from the sales amount before the transfer is made.

Articles

Where can I get the tag?

You can get it from the "<>" mark on the article list page. There are two types of tags available: JS+element and element.

Pasting tags into your blog

For those using blogs that allow free HTML customization, such as FC2 Blog, Hatena Blog, and Seesaa Blog:

Write the javascript tag* in the header, and when posting an article, paste only the element. Please use the HTML editing function in the editor of each blog service to paste the tag. (Paste in the same way as affiliate tags)

  • <script src="https://codoc.jp/js/paywall.js" defer></script>

For those using Livedoor Blog:

Paste JS+element from the HTML tag editing screen in the article posting screen.

For those using blogs where Javascript pasting is disabled, such as Ameba Blog:

Currently not supported.

For those using WordPress:

By installing the plugin, you can skip the pasting process (once configured, articles will be automatically loaded and pasted). If you are using widgets, paste only the element.

Behavior of limited sale settings

When limited sale is specified, the number of available sales decreases by one with each purchase. The number of available sales will not decrease with the purchase of a subscription that includes the article. Please note that if you change the number of sales or the price, the number will be reset.

Deletion/Unpublishing

Articles that have been purchased by an audience cannot be deleted. If you wish to stop publishing, please use the unpublish option on the article editing screen.

Where to paste the tag

The tag can be pasted on pages other than blogs, as long as Javascript is enabled. It can also be pasted in multiple locations.

Tag paste destination URL

Although not required, it is recommended to enter it. Please specify the permalink of the article where the tag was pasted. Entering it will be used on the following pages:

  1. Email sent to subscription purchasers when an article is updated.

    This will be the link to the updated article.

  2. Audience purchase page and purchase completion email.

    This will be the link to the listed article.

  3. Linked from the codoc site.

    http://codoc.jp/sites/your_display_ID/ This will be the link to the articles listed above.

  4. Also used for future feature additions.

Can I write free articles?

You can create a free article by writing the entire article body in the free section and leaving the price unspecified.

I only want to use the support feature.

We provide a support widget for this purpose. Alternatively, you can create an article with an empty body and unspecified price, and then paste the tag for that article to display only a support button on your blog. The widget tag, or the tag for a previously created support feature article, can be pasted on multiple pages, not just one.

Notifications

By enabling notifications, you can send email updates to subscribers. Please enable notifications and update your article whenever you wish to send an update. Please note that enabling notifications will send an update to all subscribers.

Preview

While you cannot preview in the strict sense until you paste the tag, you can check how the article appears using the following method:

  1. Post the article.
  2. Select "Site" from the user icon menu in the upper right.
  3. Click the title of the displayed article.
  4. The article will be displayed.
How to preview the article after purchase

From the pasted site, click "Already purchased? Log in here" and log in with your account to view the purchased article.

About script tags

As of April 22, 2020, the specification has been changed to allow script tags for external JavaScript loading. Within the codoc site, only JavaScript from some sites (Twitter/Instagram) is allowed to operate for security reasons.

Body character limit

The paid and free parts each have a limit of 1 million characters (approx. 1MB) including HTML, for a total of 1.5 million characters. Please note that applying text formatting will increase the actual character count.

Embedded Content

Authentication can be carried over to content outside the paywall. Authentication methods and supported content/services will be added sequentially.

Embedded Content (HTML)

Content protection using paywall authentication can be applied to the entire page or specific sections. Paste the Embedded Content (HTML) tag within the HTML you want to authenticate.

  1. If "Modal" is specified as the authentication method, the entire page will be blacked out, and the paywall will be displayed in a modal window.

    • Elements within the page with the codoc-element-stay class will be excluded from blacking out.
  2. If "Redirect" is selected as the authentication method, the user will be automatically redirected to the URL specified in data-auth-redirect-url.

    • For the data-auth-redirect-url attribute of the pasted tag, please specify the URL of the page where the codoc tag is placed. If not specified, a page within the codoc site will be used.
  3. Upon successful authentication, the HTML file specified as "URL" or the HTML element specified as "HTML" will replace the position of the pasted tag. For "URL", please specify a relative path or a URL to the HTML file.

Embedded Content (Matterport)

This allows codoc content purchasers to access password-protected Matterport spaces without entering a password. Please specify the password set in Matterport when registering the embedded content. When using this embedded content, the sales commission for the relevant article and associated subscriptions will increase by 2%. Please be aware of this.

Subscriptions

What is a Subscription?

Registered subscriptions can be selected on the article posting/editing screen. To subscribe to the paid part of an article, the audience will either purchase it individually or purchase a subscription associated with the article. A subscription can be associated with multiple articles. This allows the audience to read all associated articles by purchasing one subscription.

About the period
  1. One-time purchase

    • All associated articles can be read at the time of purchase. Billing is a one-time payment.
  2. Monthly

    • All associated articles can be read at the time of purchase. Billing occurs monthly, starting from the purchase date.
  3. Free trial

    • All associated articles can be read at the time of purchase. Billing occurs when the free trial ends. If cancelled before the free trial ends, no billing will occur.
    • A prescribed amount will be settled at the time of purchase for credit confirmation, but it will be refunded immediately.
Number of Subscriptions

A maximum of 100 subscriptions can be registered per account. A maximum of 5 subscriptions can be linked per article. There is no limit to the number of articles that can be linked to a subscription.

If a subscription is removed from an article

Audience members who purchased that subscription will no longer be able to view articles from which that subscription has been removed.

Deletion/Unpublishing

Subscriptions that have been purchased by an audience member at least once cannot be deleted. If you wish to stop publishing them on the site, please use the unpublish option on the article editing screen.

Period and Price Changes

If you change the period or price for a subscription that has existing purchasers, the changes will be reflected for purchases made after the change.

If you wish to apply price changes to existing purchasers, approval from the management is required. Please refer to the following flow:

  1. Inform the audience of the price change (it is advisable to announce at least one month in advance).
  2. On the subscription editing screen, check "Apply amount to existing users" simultaneously with the price change. Also, specify the desired change date.
  3. After management confirmation, the price change will be implemented on the specified change date, and billing will occur at the new price from the renewal onwards.

Affiliate

What is Affiliate

Creators can create an affiliate program for the articles and subscriptions they sell. Affiliate users can be either users who have purchased articles/subscriptions, or users specified by the creator. Users create an affiliate for each product, or receive a partnership from the creator, and then acquire an affiliate link. If a product is purchased via an affiliate link, the affiliate user can receive a commission based on the rate specified by the creator relative to the sales price.

Sales and Transfers

Sales and Transfer Status

This section explains the statuses used in Sales and Transfers on the administration screen.

  1. Trial

    • The subscription is in its trial period. It transitions from Trial in progress -> Trial canceled or Trial ended. Upon termination, payment is automatically processed as a separate sale.
  2. Pending

    • Immediately after payment is made. Will move to the next state within 24 hours.
  3. Account Unregistered

    • The status has not changed because the account is unregistered. Please register your account as soon as possible.
  4. Awaiting Confirmation

    • This is the state before it becomes available for transfer. If there are no issues with the payment information, it will usually become available for transfer after 4 business days.
  5. Available for Transfer

    • This is the state where a transfer request can be made. A transfer request can be made from "Transfers" on the administration screen when the total amount of sales available for transfer reaches 10 USD/EUR or more.
  6. Transfer Requested

    • This indicates sales for which a transfer request has been made. This is the final status in Sales.
  7. Transfer Request Canceled

    • The state where a transfer request has been canceled.
  8. Transfer Confirmed

    • The state where the transfer content has been confirmed by the administration after a transfer request has been made. It takes a minimum of 1 business day and a maximum of 30 business days from request to completion of transfer confirmation.
  9. Transferred

    • The state where the transfer has been arranged after transfer confirmation. You can usually confirm the deposit within 4 business days.
  10. Deposit Completed

    • The state where the deposit can be confirmed in your bank account. The transfer will be made under the name "Stripe Japan LLC". This is the final status in Transfers.
  11. Transfer Failed

    • The state where the transfer failed for some reason. Please contact administration.
  12. Failed

    • The state where there is some abnormality. Please contact administration.
Transfer Deadline

Please aim to complete the transfer within 90 days from the date the target sales payment was made.

Issuance of Receipts for Sales Commissions and Transfer Fees

On the transfer screen, an invoice-compliant receipt can be issued for each transfer.

Account Information

Handling of Personal Information

Names, addresses, bank account information, etc., are not stored on the codoc side, but are all stored on the Stripe side, which is used as the payment system. On the codoc side, information from the Stripe side is acquired and displayed using APIs as needed.

Changes after registration

Only the address can be changed.

Purchase

Email verification

Confirmation of your registered email address is necessary to facilitate smooth support after purchase. Please check your mailbox and verify your email from the body of the email. Please note that this does not affect content viewing.

Returns

Not supported.

Information Viewable by Creators

Only the name registered with codoc is viewable. Creators cannot view email addresses, but can indirectly send emails to audience members (purchasers) using the message function. If you do not wish to receive these emails, please adjust your email notification settings in your account.

I want to get conversion for content purchases.

This is possible on the page where the codoc tag is installed when selling with the codoc tag. This applies to individual sales, subscriptions, and support purchases. For each, a parameter named codoc_conversion will be specified in the URL where the codoc tag is installed. The values are entry, subscription, and support, which are specified for individual purchases, subscription purchases, and support, respectively.

If the codoc tag is installed on https://example.com/file.html:

Article purchased individually
https://example.com/file.html?codoc_conversion=entry

Subscription purchased
https://example.com/file.html?codoc_conversion=subscription

Supported
https://example.com/file.html?codoc_conversion=support
  • specified alphanumeric characters", "codoc* specified Kanji/Kana characters", or "コードク* specified Kana characters".

Subscribed

Prorating

Not supported.

Cancellation

No billing will occur after cancellation. The subscription will remain valid (content can be viewed) until the next scheduled renewal date.

Credit Cards

Supported Card Companies

VISA, Master, American Express, JCB, Diners, DISCOVER are supported. Debit and prepaid cards issued by each company can also be used.

Card Information

Not stored on the codoc side; stored on the Stripe side, which is used as the payment system.

Multiple Card Registration

Not supported.

Convenience Store Payment

How to apply for use

Access the application form for "Convenience Store Payment" from the link in the account settings screen. Fill in the specified fields to complete your application. After your application, a sequential review will be conducted by us and Stripe, and you will be able to use the service after approval. If there are any issues with your application, we will contact you, so please respond accordingly.

Supported convenience stores

Available at Lawson, FamilyMart, Ministop, and Seicomart.

Account

About withdrawal

Purchased articles will no longer be viewable after cancellation. Subscribed subscriptions will be automatically canceled. Audience members will lose access to all articles.

Qualified Invoice Issuer Registration Number

By registering your invoice registration number on the account screen, you can issue invoice-compliant receipts to purchasers.

Extensions

codoc pro extension

This function provides an optimized administration screen and content management method for content providers/creators using codoc and content purchasers. This function is only available when a codoc pro contract is in place. If a creator enables this, only that creator's products will be displayed on the purchaser's management screen for purchase/subscription, and the logo used on the management screen and purchase email can be changed to the creator's logo. Also, if you use the codoc login/purchase/subscription screen widget within the creator's site, you need to enable this function.

Switching Admin Screens

You can switch the admin screen when the codoc pro extension is in use and content providers/creators have been confirmed for use.

If "Use in Admin Screen" is executed by a confirmed content provider/creator

This will be an administration screen dedicated to that content provider/creator. Only the purchase history and subscribed subscriptions of that service/creator will be displayed.

To revert the administration screen to standard

From the menu, tap the "Use in Admin Screen" button for "codoc" at the top of "Switch Admin Screen".

Purchased content/subscriptions are not displayed

If you are using a dedicated administration screen for a content provider/creator, content purchased from services other than that service will not be displayed as purchased content. To display all purchased content, please revert the administration screen to standard.

If canceled

Dedicated administration screens and login functions for content providers/creators will become unavailable, and various user information and API execution permissions provided through user confirmation will no longer be disclosed to service providers/creators.

However, content already purchased can still be viewed.

Paywall

What is a Paywall?

A paywall is a billing mechanism displayed by codoc's embedded tags.

Customizing display format

Not supported. (Planned for future support)

WordPress Plugin

What is the codoc WordPress Plugin?

The codoc plugin adds the ability to sell articles created with codoc directly from the WordPress post editing screen. It supports both the new block editor and the classic editor (Classic Editor/TinyMCE).

How to install the plugin?

From the WordPress admin menu, go to Plugins -> Add New, search for "codoc", and then click "Install" and "Activate".

How to register as a member and perform initial setup?

After installing the plugin, you can register as a member and perform initial plugin setup from Settings -> codoc in the WordPress admin menu.

Plugin details

Notation based on the Act on Specified Commercial Transactions

Do creators need to set it up themselves?

No, they don't. Those who sell content through codoc can use our specified commercial transaction notation (https://codoc.jp/docs/tokusho) without disclosing their address or contact information.

Disclosure of Seller Information

If a purchaser requests disclosure of creator (seller) information, we may disclose the seller information we hold after following prescribed procedures.

I want to create my own Specified Commercial Transactions notation.

Please set it up and publish it on your own website.

Reference

Consumer Affairs Agency's view on the operation of the Act on Specified Commercial Transactions when individuals trade on platforms.

https://creator-economy.jp/n/ne52fe5d8d586

Operating Environment

Devices

Android devices, iPhone/iPad devices, PCs, Macs, etc., any device that can use a web browser.

Browser Environment

We support Chrome, Safari, and Edge browsers. If you experience any issues with operation on your device, please contact us via the inquiry form.