Nexio mock gateway integration guide

Nexio logo Nexio mock gateway is only available in the Nexio sandbox and is for testing purposes. This section is intended to help you implement the Nexio mock gateway based on your preferred integration workflow.

Services and compatibility

Supported payment types
  • Card
  • Echeck
Supported transaction types
  • Sale (saved card token, echeck token, or full card number) ( API )
  • Auth Only (saved card token or full card number) ( API )
  • Capture card (partial and greater than) ( API
Dashboard )
  • Void card ( API
  • Dashboard )
  • Refund card or echeck (partial and multiple) ( API
  • Dashboard )
    Supported processing currenciesAED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BRL, BSD, BWP, BYN, BZD, CAD, CDF, CHF, CLP, CNY, COP, CRC, CVE, CZK, DJF, DKK, DOP, DZD, EGP, ETB, EUR, FJD, FKP, GBP, GEL, GHS, GIP, GMD, GNF, GTQ, GYD, HKD, HNL, HRK, HTG, HUF, IDR, ILS, INR, ISK, JMD, JOD, JPY, KES, KGS, KHR, KMF, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, LSL, LYD, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MRU, 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, SEK, SGD, SHP, SLL, SOS, SRD, STN, SVC, SZL, THB, TJS, TND, TOP, TRY, TTD, TWD, TZS, UAH, UGX, USD, UYU, UZS, VND, VUV, WST, XCD, XOF, XPF, YER, ZAR, ZMW
    3D Secure 1.x supportedYes
    3D Secure 2.x supportedYes
    External 3D Secure supportedYes
    Installments supportedYes

    Gateway-specific information

    • Nexio mock gateway does not settle batches immediately. Transaction will automatically be settled at 05:00 UTC the following day from the transaction. For more information and how to manually settle, see Settling transactions manually below.
    • Nexio mock gateway supports security code validation.
    • Nexio mock gateway supports Address Verification Service.

    Configuration

    By default, the system automatically creates the following 3 paymentOptionTags for you to use with the Nexio mock gateway:

    • nexio - For regular transactions.
    • nexioAuto - For transactions that will auto settle.
    • nexioAsync - For 3DS transactions.

    To test out a transaction for the specific use case you have, add the value you want to the Run card transaction endpoint request in the processingOptions.paymentOptionTag parameter.

    Required fields

    There are no additional required fields.

    Testing data

    Use the following test card information to test your Nexio mock gateway configuration.

    BrandCard numberExpiration dateSecurity codeCardholder namePostal codeTransaction result
    Visa4111111111111111AnyAnyAnyAnySucccess.
    Mastercard5424000000000015AnyAnyAnyAnySucccess.
    Discover6011000000000012AnyAnyAnyAnySucccess.
    AMEX370000000000002AnyAnyAnyAnySucccess.
    Visa4556217724263850Any737AnyAnySuccess after "Gateway timeout".
    Visa4000301211112226AnyAnyAnyAnySuccess after 20 second delay. {GGG WHAT DOES THIS MEAN IN TESTER? 20s]
    Visa4000301111112227AnyAnyAnyAnySuccess after 30 second delay.
    Visa4000000011112242AnyAnyAnyAnySuccess after 40 second delay.
    Visa4000000011112259AnyAnyAnyAnySuccess after 45 second delay.
    Visa4456530000001005AnyAnyAnyAnySuccess through the frictionless 3DS flow.
    Mastercard5105105105105100Any737AnyAnySettle immediately.
    Visa4222222222222220Any737AnyAnyAuto-settles in 5 minutes.
    Visa4000701111112228Any737AnyAnyAuto-settles in 15 minutes.
    Visa4000701411112225Any737AnyAnyAuto-settles in 30 minutes.
    Visa4000701511112224Any737AnyAnyAuto-settles in 60 minutes.
    Visa4000300011112220Any737AnyAnyFail with "Insufficient funds".
    Visa4000300001112222Any737AnyAnyFail with "Credit card has expired".
    Visa4000300311112227Any737AnyAnyFail with "Card number error".
    Visa4012888888881881AnyAnyAnyAnyFail with "Gateway error".
    Visa4000300211112228Any737AnyAnyFail with "Do not honor".
    Visa4000300411112226Any737AnyAnyFail with "Verify CVC failed".
    Visa4000000011112226Any737AnyAnyFail after 50 seconds with "Gateway timeout".
    Visa4000000011112267Any737AnyAnyFail after 60 seconds with "Gateway timeout".

    Settling transactions manually

    Although regular transactions will automatically settle at 05:00 UTC the following day from the transaction, if you would like to settle the transactions before the default time, you may do so manually by sending a POST request to the Settle Mock Gateway Payments endpoint:

    POST https://api.nexiopaysandbox.com/mockGateway/v1/transactions/settle

    Use Basic authentication for the request along with the required parameter.

    Required Parameters

    merchantId - The merchant ID through which the mock transactions have been run.

    {
        "merchantId": "100039"
    }
    
    curl -X POST https://api.nexiopaysandbox.com/mockGateway/v1/transactions/settle \
      -H 'Content-Type: application/json' \
      -H 'Accept: application/json' \
      -H 'Authorization: Basic [Base64_encoded_login]'
      -d '{
        "merchantId": "100039"
    }'
    
    {
        "message": "success"
    }
    

    Status workflows

    The status of a successful transaction with Nexio mock gateway varies, depending on the options you choose.

    SaleWhen isAuthOnly is false, successful sale transactions will have the following statuses:
    • pending* or authorized
    • settled
    Auth onlyWhen isAuthOnly is true, successful sale transactions will have the following status:
    • authOnly
    CaptureSuccessful capture transactions will have the following statuses:
    • pending* or authorized
    • settled
    VoidSuccessful void transactions will have the following status:
    • voided
    RefundSuccessful refund transactions will have the following statuses:
    • pending* or authorized
    • settled

    *Pending status displays as "authorized" or "AUTHORIZED" in the Nexio Dashboard; it displays as 10, meaning "authorized", in the response when querying transactions (for more information about transactionStatus, see the appropriate transactionStatus table).

    If you have any additional questions or feedback, contact us.