Making a test payment

Get a feel for how Barion works by using the Barion Gateway API to

1. set up a payment for the Barion shop you’ve created, and
2. settle the payment with some test money from your Barion Wallet.

Prerequisites

• Completing the first part of this tutorial.
• An API testing tool such as Postman

Make a test payment using the Barion API

1. Log in to to your Barion shop.
2. Click through to Shops>Actions>Details>Secret Key (POSKey), and copy the value to the clipboard. Finding your shop’s POSKey Finding your shop’s POSKey
3. Start the Postman Desktop agent, and make a POST call to https://api.test.barion.com/v2/payment/start, passing the following JSON in the request body: Replace the POSKey and the Transactions/Payee as indicated.

{
    "POSKey": "[the POSKey you've just copied]",
    "PaymentType": "Immediate",
    "PaymentRequestId": "DEV-TEST-615",
    "FundingSources": ["All"],
    "OrderNumber": "Order_01",
    "RedirectUrl": "https://example.com/",
    "Currency": "EUR",
    "Locale":"en-US",
    "GuestCheckOut": true,
    "PaymentWindow":"00:30:00",
    "Transactions": [
        {
            "POSTransactionId": "DEV-TEST-01-01",
            "Payee": "[the email address associated with the Barion shop]",
            "Total": 100,
            "Comment": "Test transaction",
            "Items": [
                {
                    "Name": "Nada",
                    "Description": "Zilch",
                    "Quantity": 1,
                    "Unit": "db",
                    "UnitPrice": 1,
                    "ItemTotal": 1,
                    "SKU": "SM-01"
                }
            ]
        }
    ]
}

For details on the various parameters you’re passing in the call, see the Payment/Start API endpoint reference.

Step result: The API request returns the following JSON:

{  "PaymentId": [the payment ID generated for the transaction],  "PaymentRequestId": "DEV-TEST-187",  "Status": "Prepared",  "QRUrl": "<nowiki>https://api.test.barion.com/qr/generate?paymentId=</nowiki>[the payment ID generated for the transaction]&size=Large",  "Transactions": [  {  "POSTransactionId": "DEV-TEST-01-01",  "TransactionId": [the payment ID generated for the transaction],  "Status": "Prepared",  "Currency": "EUR",  "TransactionTime": "0001-01-01T00:00:00",  "RelatedId": null  }  ],  "RecurrenceResult": "None",  "ThreeDSAuthClientData": null,  "GatewayUrl": "<nowiki>https://secure.test.barion.com/Pay?Id=2</nowiki>[the payment ID generated for the transaction]",  "RedirectUrl": "<nowiki>http://barion.com/?paymentId=</nowiki>[the payment ID generated for the transaction]",  "CallbackUrl": "",  "TraceId": null,  "Errors": []  }

Pay through the Barion Smart Gateway:

Go to the URL in the POST call’s GatewayURL return value, and complete the purchase using the following test card details:

• Card number: 4444 8888 8888 5559
• Expiration date: any future date
• CVC: any 3-digit number

 *The Test Payment Gateway for Your API-prompted Transaction*

Next steps

• Go live with your Barion Shop
• Dive into the Barion Payment API
• Set up a recurring payment/subscription