---
title: Transaction
slug: payments/NzLO-transaction
docTags: 
createdAt: 2024-06-17T12:27:48.572Z
---

## Basic URL Structure

:::CodeblockTabs
Button URL

```css
/apex/bw_payments__CreateTransaction
?originating_record={!salesforce_record_ID} 
&parent_id=lookup_api_field__c
```
:::

Please note that the only field that should contain a Salesforce ID is the originating record field. Additionally, this is the only field containing brackets, \{}. All other fields will contain the API name of the field *without&#x20;*&#x62;rackets. The API name is easiest copied from the Salesforce Setup page, which shows all the fields on the originating object.

## Testing

We recommend using \&testing=true to access our testing page when building the URL. You can temporarily build this into the URL formula or append it to the URL after clicking the New Transaction button. This testing page will display the API names you have been passed and the corresponding values Breadwinner retrieved based on the API names. It acts as a confirmation page and is visible only when testing is set to true.&#x20;

:::CodeblockTabs
Button URL

```css
/apex/bw_payments__CreateTransaction
?originating_record={!salesforce_record_ID} 
&parent_id=lookup_api_field__c
&testing=true
```
:::

Once you review and feel confident, you may remove the \&testing=true from the Button URL.

## Transaction Level Fields

### Payment Amount

You can optionally populate the Payment Amount using the Originating object field. A Formula field with a number data type will also work. If you assign the field API name to the payment\_amount param, Breadwinner will show this field value on the Payment Amount.

:::CodeblockTabs
Button URL

```css
&payment_amount=amount_api_field__c
```
:::

### Payment Currency

You can optionally populate the Payment Currency using the Originating object field. A Formula field with a text data type will also work. If you assign the field API name to the payment\_currency parameter, Breadwinner will show this field value in the Payment Currency.

:::CodeblockTabs
Button URL

```css
&payment_currency=currency_api_field__c
```
:::

### Payment Description

You can optionally populate the Payment Description using the Originating object field. A Formula field with a text data type will also work. If you assign the field API name to the payment\_description parameter, Breadwinner will show this field value in the Payment Description.

:::CodeblockTabs
Button URL

```css
&payment_description=description_api_field__c
```
:::

## Summary of all fields available for a New Transaction

The structure of a Button URL to create a new Transaction with all possible fields is shown below.&#x20;

:::CodeblockTabs
Button URL

```css
/apex/bw_payments__CreateTransaction
?originating_record={!salesforce_record_ID} 
&parent_id=lookup_api_field__c
&payment_amount=amount_api_field__c
&payment_currency=currency_api_field__c
&payment_description=description_api_field__c
&testing=true
```
:::



