SafeCharge

SafeCharge has some special integration requirements. Follow the standard PaymentsOS integration procedure, and then apply the relevant extra specifications described below.

Warning

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.

SpecificationsDetails
Minimum PaymentsOS API Version1.2.0
Requests
  • Authorize
  • Capture (including multiple/partial)
  • Charge
  • Credit
  • Refund (including multiple/partial)
  • Void
CurrenciesAED, 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.
Payment Methods
  • MASTERCARD
  • VISA
Contact your SafeCharge account representative if you require additional payment methods.
3DS RedirectionSupported

Configurations

The following table lists the configurations that are specific to SafeCharge.

ConfigurationRequired/Optional
In the PaymentsOS Control Center, configure the following credentials:
  • merchantId: The merchant ID provided by SafeCharge.
  • merchantSiteId: The merchant Site ID provided by SafeCharge.
  • merchantSecretKey: The secret key provided by SafeCharge.
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:
  • Capture. This is known as Settle in your SafeCharge account. Enabling Capture requests is required if you use Authorize requests.
  • Void
  • Credit. This is known as Payout in your SafeCharge account.
Optional
In your SafeCharge account, you can configure your risk settings so that the following fields are optional:
  • Billing Country
  • Email Address
  • CVV
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

Sample Requests

Use the bodybuilder to create a sample request body for each request type.

Testing

Use the testing resources provided in the SafeCharge documentation.

results matching ""

    No results matching ""