SafeCharge has some special integration requirements. Follow the standard PaymentsOS integration procedure, and then apply the relevant extra specifications described below.
A SafeCharge account can be configured to use either Charge or Authorize, but not both. Any request you create in PaymentsOS should therefore match the request type you chose to use in SafeCharge (do not create an Authorize request in PaymentsOS if you use Charge in SafeCharge and, vice versa, do not create a Charge request in PaymentsOS if you use Authorize in SafeCharge). Failing to do so will cause unwanted behavior, such as an actual transfer of funds when issuing an Authorize request or a mismatch in request statuses between PaymentsOS and SafeCharge.
Specifications for Card-based Transactions
The following table lists the integration specifications for SafeCharge.
|Minimum PaymentsOS API Version||1.2.0|
|Currencies||AED, ARS, AUD, AZN, BGN, BHD, BND, BRL, BYN, BYR, CAD, CHF, CLP, CNH, CNY, COP, CRC, CZK, DKK, DZD, EEK, EGP, EUR, GBP, GEL, HKD, HRK, HUF, IDR, INR, IQD, ISK, JOD, KGS, KRW, KWD, KZT, LBP, LTL, LVL, MAD, MDL, MXN, MYR, NIS, NOK, NZD, OMR, PEN, PHP, PKR, PLN, QAR, RON, RSD, RUB, SAR, SEK, SGD, SKK, THB, TND, TRY, TWD, UAH, USD, UYU, VEF, VND, YEN, YER, ZAR.|
The following table lists the configurations that are specific to SafeCharge.
|In the PaymentsOS Control Center, configure the following credentials: ||Required|
|In the PaymentsOS Control Center, register webhooks to be notified when a transaction changes its status. This is recommended if you enabled 3DS.||Optional|
|In your SafeCharge account, create separate merchant accounts if you want to use both Charge and Authorize requests. This requires that you create separate provider configurations in the PaymentsOS Control Center as well. Note: With SafeCharge you can use either Charge or Authorize, but not both. If you require both, create a separate merchant account for each request type.||Optional|
|In your SafeCharge account, enable the transaction request types you would like to use:||Optional|
|In your SafeCharge account, you can configure your risk settings so that the following fields are optional:||Optional|
|In your SafeCharge account, enable passing of a soft descriptor in your payment requests. Note: This is known as a Dynamic Descriptor in your SafeCharge account.||Optional|
Use the bodybuilder to create a sample request body for each request type.
Use the testing resources provided in the SafeCharge documentation.