Skip to main content

Welcome to our Billwerk+ Optimize Help Center

Card import from your old payment service provider

This guide shows you how a card import is done and what you need to do.

If you have saved payment cards at your current payment service provider, a card import has to be done as a part of your transfer to Billwerk+.

The exchange and handling of card data must only be done by PCI Level 1 certified companies like Billwerk+. However, some actions are required by you. Please look at the process below:

  1. You - Ensure that all new cards and all new transactions are processed through Billwerk+. See this guide.

  2. You - Send an email to your current payment service provider and ask to move all your saved payment cards to Billwerk+. Please add ree-support@billwerk.plus on cc.

  3. Billwerk+ - Billwerk+ and your current payment service provider plan and schedule the export/import.

  4. Billwerk+ - Billwerk+ receives the cards.

  5. Billwerk+ - Billwerk+ sends a CSV file to you with two columns.

    1. One column with your old payment service provider card ID.

    2. One column with new Billwerk+ card tokens.

    At the bottom of this guide, you can see an example of a card import file.

  6. You - Create a script where you call Add Payment Method API:

    1. Here you need to specify the Billwerk+ card token from step 5.

    2. Choose whether:

      • this card should be saved on an existing customer using an existing customer handle or

      • create a new customer.

    3. When you call add_payment_method, you will get a card ID in return.

      e.g. ca_fcfac2016614418f969fa5697383e47c.

    4. You must store this ID in your own database. The old payment service provider ID must be replaced with this new Billwerk+ card ID.

  7. You - When all new Billwerk+ card IDs is stored in your own database, you will have to call Billwerk+ to charge on these card going forward.

  8. You - Now you report back to your current payment provider so that they can close the agreement definitively.

    Note

    Remember, however, that one should still be able to refund for a while.

Card import file example:

The output file contains all the imported cards.
The output file is using semicolon as a delimiter. 
It consists of the following columns:

<id1>;<id2>;<reepay_temporary_token>
"Id1" is the card identifier from the old PSP 
"Id2" is the second card identifier from the old PSP. 

This column will be omitted if the old PSP only supplies asingle identifier.
"reepay_temporary_token" is the one-time token referencing an imported card.

Example:
12345677;42441;ct_ca7b393ebb0ab1b59ea075b55adae344
12345671;42442;ct_c6e16fd3f3c01cd1e92137ca0bb5b0e8
12345672;42443;ct_4940286230dbda172c391153034bd6c2
12345673;42444;ct_b38c72778b97986f19fbda396c31c231
12345674;42445;ct_b75e50c5bcd6a41f19f20f36d19367e1
123456715;42446;ct_3563d85177e2389af67e979ba2fbe7b1
123456718;412447;ct_34a4191f637f9b97b7f05cecbb911ec6
123456719;987448;ct_105d4994a19350b7924291e24c11ee5e
In this section: