Skip to main content

Welcome to our 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 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.


    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" 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.