Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Payments can also be posted when orders are placed.


Note

Note: Payments of type

...

credit_card

...

will fail, even in Sandbox, if you have not yet signed up for the Braintree gateway.

Parameters

Name

Description

Value Type

Required

Other

typeamount

The type amount of the payment to be posted. Available types:

  • cash

  • check

  • paypal

  • money_order

  • tbd

  • evopay

  • credit_card

  • offline

String

Required. Will be created for order total if omitted.

Decimal

Optional

Maximum 2 decimal places

billing_address_id

ID of a Client Address which is the billing address for the credit card being used.

Integer

Required if type is "credit_card"

is_completed

Automatically transition state from "pending" to "completed" after creation

Boolean

Optional

is_refund

Create payment in the opposite direction, where the order seller will refund money to the buyer.

Boolean

Optional

order_id

ID of the order on which the payment will be created

Integer

Optional

payment_method_token

or

payment_method_nonce

Currently usable when your you are using our Braintree credit card gateway is Braintree. Use the methods Braintree provides such as their Drop-in UI or Hosted Fields to retrieve either a reusable token or a single-use nonce and pass to use us in way that does not require sending other credit card information through our API.

StringOptional

Required when type is credit_card.

Only usable on /v9 and when type is credit_card.

order_id

ID type

The type of the order on which the payment will be created

integer

Required

is_refund

Create payment in the opposite direction, where the order seller will refund money to the buyer.

boolean

Optional

amount

The amount of the payment. Will be created for order total if omitted.

Decimal

Optional

Maximum 2 decimal places

billing_address_id

ID of an address

integer

Required if type is "credit_card"

is_completed

Automatically transition state from "pending" to "completed" after creation

boolean

Optionalto be posted. Available types:

  • cash

  • check

  • credit_card

  • evopay

  • money_order

  • offline

  • paypal

  • tbd

String

Required



Examples

Request

Response

/v9/payments



Code Block
languageruby
{
  "payments":[
    {
      "order_id":"75155",
      "type":"cash",
      "amount":"15"
    }
  ]
}



See Payments / Index

...