Payments Overview

Avenu currently offers payment capabilities in the form of ACH transfers. Version 1 of Avenu's API supports debit card funding of a customer's account and ACH origination. Debit funding is available to instantiate an account balance. There are also endpoints available to retrieve payment statuses and details, create a dispute, and administer customer payment adjustments.

PaymentsEndpoints
Fund account via debit cardcustomer/v1/fund
Fund account via tokenized debit cardcustomer/v1/token/fund
Send payments, see payment detailscustomer/v1/payment
See payment statuscustomer/v1/payment/status
See recent paymentscustomer/v1/payments

Statuses

These are codes returned when requesting status updates or posting a payment.

CodeDescription
PENDINGA pending settlement
FAILEDThe payment failed
SETTLEDThe payment has been settled
DECLINEDThe payment has been declined
CANCELEDThe payment has been canceled
AUTHORIZEDThe debit card funding has been authorized
CAPTUREDThe debit card funding has been captured. Funds are available for customer use.

Payment Types

The currently available payment types in Avenu's v1 API

TypeDescriptionTransaction ID Prefix
AVENUPayment between Avenu customerss.{UUID} (sender) r.{UUID} (receiver)
ACHPayment to/from an ACH accounta.{UUID}
RETURNACH payments that have been returned by the receiver. Returns with the following return codes will result in the associated customer account being SUSPENDED: R02, R03, R04, R05, R07, R08, R10, R11c.{UUID}
DEBIT_CARD_FUNDA debit card fundingcf.{UUID}
ACH_TRANSFERTransfer from customer's account to a client's accountt.{UUID}
TRANSFER_REFUNDA return from the client's account to a customer's accounttr.{UUID}
ADJUSTMENTTransaction type when a disputed transaction is adjusted because compliance found an error has occurred or provides a provisional credit. If a provisional credit is applied and later found that "no error occurred" then the reversal transaction will also have ADJUSTMENT as paymentType with a "jr." prefix.j.{UUID} / jr.{UUID}
MANUAL_ADJUSTMENTA manual adjustment transaction made by Avenu adminm.{UUID}
DEBIT_FUND_CHARGEBACKA chargeback received by the merchant processor from a disputed debit card funding transaction.n/a