Skip to main content

Documentation Index

Fetch the complete documentation index at: https://integration.wpay.com.au/llms.txt

Use this file to discover all available pages before exploring further.

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. 
var transaction = await client.Transactions.CreateAsync(
    transactionCreate: new TransactionCreate()
    {
        Amount = 1299,
        Currency = "AUD",
        Country = "AU",
        PaymentMethod =
            TransactionCreatePaymentMethod.CreateCheckoutSessionWithUrlPaymentMethodCreate(
                new CheckoutSessionWithUrlPaymentMethodCreate()
                {
                    Id = checkoutSession.Id,
                }
            ),
    }
);
The returned transaction includes details about the payment method used, and the status of the transaction. 
{
  "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.