Cards

# Introduction

Credit and debit cards are one of the most popular e-payment methods. With Straal solutions, you can quickly and securely accept payments made with cards of all major schemes and in more than 150 currencies.

You can use credit and debit cards for a variety of payments, all supported by Straal:

  • one-shot payments
  • one-click payments
  • subscriptions, charged automatically
  • POS payment in your offline shop

We accept cards from the following card schemes:

Logos of the following card schemes: MasterCard, VISA, Maestro, JCB, UnionPay, Discover, AMEX, Cartes Bancaires, Dankort (DK) and Diners Club

# Supported Currencies

Straal supports over 150 different payment currencies and over 10 settlement currencies:

Currency type SWIFT code
Settlement currencies EUR, USD, GBP, PLN, CAD, CHF, HUF, SEK, NZD, NOK, DKK, HKD, AUD, JPY, HRK, TRY, CZK, RON, ZAR, SGD
Payment currencies AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BRL, BSD, BTN, BWP, BYR, BZD, CAD, CDF, CHF, CLP, CNY, COP, CRC, CUP, CVE, CZK, DJF, DKK, DOP, DZD, EGP, ERN, ETB, EUR, FJD, FKP, GBP, GEL, GHS, GIP, GMD, GNF, GTQ, GYD, HKD, HNL, HRK, HTG, HUF, IDR, ILS, INR, IQD, IRR, ISK, JMD, JOD, JPY, KES, KGS, KHR, KMF, KPW, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, LSL, LTL, LVL, LYD, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MUR, MVR, MWK, MXN, MYR, MZN, NAD, NGN, NIO, NOK, NPR, NZD, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, RWF, SAR, SBD, SCR, SDG, SEK, SGD, SHP, SLL, SOS, SRD, STD, SVC, SYP, SZL, THB, TJS, TMT, TND, TOP, TRY, TTD, TWD, TZS, UAH, UGX, USD, UYU, UZS, VEF, VND, VUV, WST, XAF, XCD, XOF, XPF, YER, ZAR, ZMW, ZWD

The specific list will depend on your setup. To talk about details, consult our Sales Team

# Use case – adding a card

If you want to use a card in a one-click or a recurring transaction, you need to create a card object in Straal. It also makes it easier to use cards in later transactions, because you can use the card's ID instead of its details.

If you wish to use the Straal API to add a card, you need to send a POST request to API endpoint /customers/:customer_id/cards, where :customer_id needs to be substituted with the customer's ID (see APIref: Create a card(opens new window) ). In case of new customers, you will have to create a customer object first (see APIref: Create a customer(opens new window) ).

Sample request

{
  "name": "John Smith",
  "number": "4111111111111111",
  "cvv": "123",
  "expiry_month": 11,
  "expiry_year": 2018,
  "origin_ipaddr": "91.17.133.219"
}

To see a sample response, see APIref: Create a card(opens new window) . To learn more about working with cards, see APIref: Cards(opens new window) .