Newline Platform API

Getting Started
Auth
- Generate an authentication tokenpost
Customers
Pools
- List Poolsget
- Get a single Poolget
Products
- List Productsget
- Get a single Productget
Customer Products
Custodial Accounts
Synthetic Accounts
Transfers
Sandbox
- Simulate a Transactionpost
Transactions
Debit Cards
Virtual Reference Numbers
Returns
Combined Transfers

Newline Platform API

Getting Started
Auth
- Generate an authentication tokenpost
Customers
Pools
- List Poolsget
- Get a single Poolget
Products
- List Productsget
- Get a single Productget
Customer Products
Custodial Accounts
Synthetic Accounts
Transfers
Sandbox
- Simulate a Transactionpost
Transactions
Debit Cards
Virtual Reference Numbers
Returns
Combined Transfers

Approve or deny a transaction

put https://sandbox.newline53.com/api/v1/transactions/{uid}/authorize

Path Params

uid

string

required

Newline-generated unique id resource specific to the current endpoint

Body Params

authorization_status

string

required

The current status of the transaction authorization.

denied_memo

string

The memo that should be attached to the transaction if the transaction has been denied. Optional.

denied_reason

string

The reason for the authorization denial. For wire transactions, must be one of (vrn_archived), (vrn_locked), (international_payment), (unauthorized_credit). For ACH transactions, must be one of (vrn_archived), (vrn_locked), (debit_limit_exceeded), (unauthorized_credit), (unauthorized_debit), (insufficient_funds)

Headers

x-trace-id

string

required

A unique identifier provided for each request. Duplicate values submitted in requests within 7 days of each other will cause the request to be rejected.

Responses

Response body

object

authorization

object

Transaction Authorization information. Only present if authorization was required for a given transaction.

authorization_finalized_at

date-time

The date and time when authorization for this transaction got finalized. It will only appear if authorization status is in one of the final statuses: auto_approved, auto_denied, client_approved, client_denied, client_unanswered_auto_approved or client_unanswered_auto_denied.

authorization_required_by

date-time

The date and time representing the deadline by which the authorization decision should be made by client. If no authorization is provided by this date, the transaction status will transition to client_unanswered_auto_approved.

authorization_status

string

A value indicating the current state of authorization for this transaction.

auto_approved auto_denied client_approval_pending client_approved client_denied client_unanswered_auto_approved client_unanswered_auto_denied created

denied_memo

string

Freeform text (up to 44 characters) attached as a memo to authorization. It will only appear if authorization status is auto_denied, client_denied or client_unanswered_auto_denied.

denied_reason

string

A description of why the authorization was denied. It will only appear if authorization status is auto_denied, client_denied or client_unanswered_auto_denied.

Headers

object

x-trace-id

string

The unique identifier provided with the request.

Response body

object

errors

array of objects

errors

object

code

integer

Code provided by Newline for reference

title

string

Title of Error Code

detail

string

Description of Error Code

occurred_at

string

Error Timestamp

extra

string

Included based on Error Code; Additional context to help users self-solve the error

status

integer

HTTP Status Code

Headers

object

x-trace-id

string

The unique identifier provided with the request.

Response body

object

errors

array of objects

errors

object

code

integer

Code provided by Newline for reference

title

string

Title of Error Code

detail

string

Description of Error Code

occurred_at

string

Error Timestamp

extra

string

Included based on Error Code; Additional context to help users self-solve the error

status

integer

HTTP Status Code

Headers

object

x-trace-id

string

The unique identifier provided with the request.

Updated 6 months ago

Get a single Transaction

List Transaction Events

Did this page help you?

Language

Credentials

Header


xxxxxxxxxx
1
curl --request PUT \
2
     --url https://sandbox.newline53.com/api/v1/transactions/uid/authorize \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json' \
5
     --data '
6
{
7
  "authorization_status": "client_approved"
8
}
9
'

Choose an example:

application/json

Updated 6 months ago

Get a single Transaction

List Transaction Events

Did this page help you?

Newline Platform API
Getting Started
Auth
Generate an authentication tokenpost
Customers
Customer Statuses
Archive a Customerdelete
Adjust Customer Dataput
Get a single Customerget
Create a new Customerpost
Get a list of Customersget
Overview of Customer Types
Pools
Get a single Poolget
List Poolsget
Products
Get a single Productget
List Productsget
Customer Products
Customer Product Statuses
Get a single Customer Productget
Onboard Customer onto a Productpost
List Customer Productsget
Custodial Accounts
Custodial Account Statuses
Get a single Custodial Accountget
List Custodial Accountsget
Synthetic Accounts
Synthetic Account Statuses
Synthetic Account Categories
Archive a Synthetic Accountdelete
Update the Synthetic Account metadataput
Get a single Synthetic Accountget
Create a New Synthetic Accountpost
List Synthetic Accountsget
Get a Single Synthetic Account Typeget
List Synthetic Account Typesget
Transfers
Transfer Statuses
Cancel a Transferput
Get a single Transferget
Initiate a Transferpost
List Transfersget
Sandbox
Simulate a Transactionpost
Transactions
Debit Card Denied Authorization Reasons
Transaction Statuses and Types
Get a single Custodial Line Itemget
List Custodial Line Itemsget
Get a single Synthetic Line Itemget
List Synthetic Line Itemsget
Get a single Transaction Eventget
List Transaction Eventsget
Approve or deny a transactionput
Get a single Transactionget
List Transactionsget
Debit Cards
Get a virtual Debit Card imageget
Migrate a virtual Debit Card to a physical Debit Cardput
Get Debit Card access tokenget
Get Debit Card PIN tokenget
Reissue a Debit Cardput
Unlock a Debit Cardput
Lock a Debit Cardput
Activate a Debit Cardput
Get a single Debit Cardget
Create a new Debit Cardpost
List all Debit Cardsget
Virtual Reference Numbers
Virtual Reference Number Statuses
Unlock a single Virtual Reference Numberput
Lock a single Virtual Reference Numberput
Archive a single Virtual Reference Numberdelete
Edit a Virtual Reference Numberput
Get a single Virtual Reference Numberget
Create a new Virtual Reference Numberpost
List Virtual Reference Numbersget
Returns
Get a single Returnget
Create a new Returnpost
List Returnsget
Combined Transfers
Get a single Combined Transferget
Create a new Combined Transferpost
List Combined Transfersget

Newline Platform API
Getting Started
Auth
Generate an authentication tokenpost
Customers
Customer Statuses
Archive a Customerdelete
Adjust Customer Dataput
Get a single Customerget
Create a new Customerpost
Get a list of Customersget
Overview of Customer Types
Pools
Get a single Poolget
List Poolsget
Products
Get a single Productget
List Productsget
Customer Products
Customer Product Statuses
Get a single Customer Productget
Onboard Customer onto a Productpost
List Customer Productsget
Custodial Accounts
Custodial Account Statuses
Get a single Custodial Accountget
List Custodial Accountsget
Synthetic Accounts
Synthetic Account Statuses
Synthetic Account Categories
Archive a Synthetic Accountdelete
Update the Synthetic Account metadataput
Get a single Synthetic Accountget
Create a New Synthetic Accountpost
List Synthetic Accountsget
Get a Single Synthetic Account Typeget
List Synthetic Account Typesget
Transfers
Transfer Statuses
Cancel a Transferput
Get a single Transferget
Initiate a Transferpost
List Transfersget
Sandbox
Simulate a Transactionpost
Transactions
Debit Card Denied Authorization Reasons
Transaction Statuses and Types
Get a single Custodial Line Itemget
List Custodial Line Itemsget
Get a single Synthetic Line Itemget
List Synthetic Line Itemsget
Get a single Transaction Eventget
List Transaction Eventsget
Approve or deny a transactionput
Get a single Transactionget
List Transactionsget
Debit Cards
Get a virtual Debit Card imageget
Migrate a virtual Debit Card to a physical Debit Cardput
Get Debit Card access tokenget
Get Debit Card PIN tokenget
Reissue a Debit Cardput
Unlock a Debit Cardput
Lock a Debit Cardput
Activate a Debit Cardput
Get a single Debit Cardget
Create a new Debit Cardpost
List all Debit Cardsget
Virtual Reference Numbers
Virtual Reference Number Statuses
Unlock a single Virtual Reference Numberput
Lock a single Virtual Reference Numberput
Archive a single Virtual Reference Numberdelete
Edit a Virtual Reference Numberput
Get a single Virtual Reference Numberget
Create a new Virtual Reference Numberpost
List Virtual Reference Numbersget
Returns
Get a single Returnget
Create a new Returnpost
List Returnsget
Combined Transfers
Get a single Combined Transferget
Create a new Combined Transferpost
List Combined Transfersget

200The authorization resource is returned

400Bad authorization request

422An exception occurred while authorizing transaction