Create Transaction

post

https://{subdomain}.recurly.com/v2/transactions

The Recurly API provides a shortcut for creating an invoice, charge, and optionally account, and processing the payment immediately. When creating an account all of the required account attributes must be supplied. When charging an existing account only the account_code must be supplied.

Using stored billing info

You may create a transaction without specifying billing information if an account already has stored billing information.

xml

PHP

Ruby

Python

text

<transaction>
  <amount_in_cents>100</amount_in_cents>
  <currency>USD</currency>
  <account>
    <account_code>1</account_code>
  </account>
</transaction>

$transaction = new Recurly_Transaction();
$transaction->amount_in_cents = 100; // $1.00
$transaction->currency = 'USD';

$transaction->account = new Recurly_Account();
$transaction->account->account_code = '1';

$transaction->create();

transaction = account.transactions.create(
  :amount_in_cents => 1_00,
  :currency        => 'USD',
  :account         => { :account_code => '1' }
)

transaction = Transaction(
  amount_in_cents=100,
  currency='USD',
  account=Account(account_code='1')
)
transaction.save()

var transaction = new Transaction("1", 100, "USD"); // account code, unit amount in cents, currency
transaction.Create();

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

amount_in_cents

integer

Amount of the transaction in cents. Max 10000000.

currency

string

3-letter currency for the transaction

description

string

A description for the transaction. Description is added to the invoiced charge, and not the transaction object

account

object

nested attributes (see below)

account_code

string

A unique identifier used by your application to identify the account. This code may only contain the following characters: [a-z A-Z 0-9 @ - _ .]. Max of 50 characters.

username

string

Username, ignore if you do not use usernames

string

Email address

first_name

string

First Name. Max 50 characters.

last_name

string

Last Name. Max 50 characters.

company_name

string

Company name. Max of 50 characters.

accept_language

string

An ISO 639-1 language code from the user's browser, indicating their preferred language and locale.

billing_info

object

account->billing_info nested attributes (see below)

company

string

Company name. Max of 50 characters.

address1

string

Address line 1, recommended for address validation. Max 50 characters.

address2

string

Address line 2. Max 50 characters.

city

string

City. Max 50 characters.

state

string

State or Province, 2-letters preferred

country

string

Country, 2-letter ISO code. Strongly Recommended

zip

string

Zip or postal code, recommended for address validation. Strongly Recommended

phone

string

Phone number

vat_number

string

Customer's VAT Number

ip_address

string

Customer's IP address when updating their billing information. Strongly Recommended.

number

string

Credit card number, spaces and dashes are accepted.

month

string

Expiration Month

year

string

Expiration Year

verification_value

string

Security code or CVV, 3-4 digits. Strongly Recommended.

Response

200