Payment Methods

Credit Cards

Providers:

creditcard

ACI
creditcard

MiPay

ACI

                                                        
{
   "id":"7bb6f1f3-d280-4b0c-a74f-90471ea69426", // Auto-generated UUID
   "paymentMethod":"creditcard",
   "returnUrl": "http://example.com", // URL to return after payment completion.
   "webhookUrl": "https://example.com", // URL to receive webhook notification.
   "transaction":{
      "reference": "11111-1111", // Max 20 character long
      "currency": "EUR", // ISO 4217 format currency
      "amount": 2000, // The amount is in cents, 2000 = 20 EUR
      "description": "11111-1444",
      "lines":[
         {
           "name": "Some Voucher - 20 EUR", // Max 100 characters. Name of product.
            "category": "PREPAID-VOUCHER", // Max 100 characters.
            "brand": "alphacomm", // Max 100 characters.
            "quantity": 1, // Number of items
            "amount": 2000 // The amount is in cents, 2000 = 20 EUR
         }
      ]
   },
   "provider":"ACI"
}

Sandbox Testing

ACI sandbox payment will only support specific credit card numbers for testing successfull payments flow use Card No 
4111 1111 1111 1111
expire date in future, rest of fields can be anything. You can also test failed payments and trigger specific response in those cases, for failing payments on fraud side use 
4444 3333 2222 1111
for failing payments on 3DS

Anti-fraud Check

Fraud check (Cynic) is supported for this Provider.

Beside configuration set for fraud check. It is required for payer data to be sent along with request. Example below.


                                                        
{
   "id":"7bb6f1f3-d280-4b0c-a74f-90471ea69426", // Auto-generated UUID
   "paymentMethod":"creditcard",
   "returnUrl": "https://example.com", // URL to return after payment completion.
   "webhookUrl": "https://example.com", // URL to receive webhook notification.
   "transaction":{
      "reference": "test-1111", // Max 20 characters
      "currency": "EUR", // ISO4217 format
      "amount": 2000, // The amount is in cents, 2000 = 20 EUR. Has to be sum of amounts * quantity in lines.
      "description": "test-1444",
      "lines":[
         {
            "name": "Some Voucher - 20 EUR", // Max 100 characters. Name of product.
            "category": "PREPAID-VOUCHER", // Max 100 characters.
            "brand": "alphacomm", // Max 100 characters.
            "quantity": 1, // Number of items
            "amount": 2000 // The amount is in cents, 2000 = 20 EUR
         }
      ]
   },
   "payer": {
        "id": "1337", // Unique numeric value specific per payer
        "email": "john@alphacomm.nl", // Max 64 characters.
        "deviceId": "a80d683678514df2b3c952f48b095266", // Max 50 characters.
        "billing": {
            "firstName": "Jhon", // Max 128 characters. To test decline of Fruad check flow set value to DECLINE
            "lastName": "Doe", // Max 128 characters
            "street": "Scheepmakerspassage 183", // Max 128 characters. Billing street with number.
            "city": "Rotterdam",
            "zip": "3011VH", // Max 50 characters. Customer postal code.
            "phone": "+31612345678", // Phone number with Country code.
            "email": "john@alphacomm.nl",  // Max 64 characters.
            "country": "NL" // Country code ISO3166 format
        },
        "shipping": {
            "firstName": "John", // Max 128 characters.
            "lastName": "Doe", // Max 128 characters.
            "street": "Scheepmakerspassage 183", // Shipping street with number.
            "city": "Rotterdam",
            "zip": "3011VH", // Max 50 characters. Customer postal code.
            "phone": "+31612345678", // Phone number with Country code.
            "email": "john@alphacomm.nl",  // Max 64 characters.
            "country": "NL" // Country code ISO 3166 format
        },
        "ipAddress": "127.0.0.1", // Support only ipv4
        "language": "nl", // Language code ISO 639-1 format
        "status": "registered", // Can be "guest", "registered", "registered-unconfirmed"
        "verificationStatus": "phone", // Can be "identification", "phone", "trusted", "otherwise"
        "dateRegistration": "2016-01-01T13:56:48+0100", // Date format ISO 8601
        "dateLastUpdated": "2016-01-01T13:56:48+0100", // Date format ISO 8601
        "dateFirstPurchase": "2016-01-01T13:56:48+0100", // Date format ISO 8601
        "channel": "web"  // Can be "web" or "app"
   },
   "provider":"ACI",
}

Merchant configuration

  • Environment - can be set live or test
  • Token - ACI auth parameter (Dev providing, for additional information contact dev team)
  • Entity ID - ACI auth parameter (Dev providing, for additional information contact dev team)
  • Creditcard Authorization - Pre-authorisation or Final authorisation (Aci specific parameter)
  • 3D secure - boolean(on/off) , enable or disable 3DS
  • 3D secure extended widget - boolean (true/false), will prompt additional fields to populate for 3DS in payment widget
  • 3d secure exemption - boolean (on/off), to skip 3DS
  • Currency - ACI used parameter to what currecy will be used in account
  • Authorize on registration - boolean (true/false)
  • Disable registration checkout - boolean (true/false)