Step 4: Create a transaction

The final step is to use the card data stored using Secure Fields to either create a transaction or store a card on file for later use.

Create a transaction

Card data stored in a checkout session can be used to create a transaction.

C#

var transaction = await _client.Transactions.CreateAsync(
    transactionCreate: new TransactionCreate()
    {
        Amount = 1299,
        Currency = "USD",
        Country = "US",
        PaymentMethod =
            TransactionCreatePaymentMethod.CreateCheckoutSessionWithUrlPaymentMethodCreate(
                new CheckoutSessionWithUrlPaymentMethodCreate()
                {
                    Id = checkoutSession.Id,
                }
            ),
    }
);

The returned transaction includes details about the payment method used, and the status of the transaction.

Response

{
  "type": "transaction",
  "id": "fe26475d-ec3e-4884-9553-f7356683f7f9",
  "status": "authentication_succeeded",
  "amount": 1299,
  "currency": "AUD",
  "payment_method": {
    "type": "payment-method",
    "id": "77a76f7e-d2de-4bbc-ada9-d6a0015e6bd5",
    "method": "card",
    "scheme": "visa",
    "expiration_date": "07/24",
    ...
  },
  ...
}

Store a card for later use

Card data in a checkout session can also be used to create a stored payment method that can be used again later. This can be done either at the time of creating a transaction by setting the store property to true, or when creating a new payment method directly from the checkout session.

This deletes the security_code from the vault and any transaction created later requires the code to be requested again.

3-D Secure

3-D Secure can be used in conjunction with Secure Fields using the hosted 3DS solution. To enable hosted 3DS, add a redirect_url to the API call to create a transaction, and then redirect the buyer to the approval_url in the response.

Summary

In this step you:

• Used the checkout session to create a transaction or store a payment method

Next

That’s it for the quick start guide. It’s recommended to look into some of the additional options, theming, adding logos, and how to work with stored cards.