Transaction Status

This comprehensive reference details all transaction status codes returned by the Localpayment API. Understanding these statuses is crucial for tracking transaction lifecycles, handling different scenarios, and building robust payment integrations.

Overview

Transaction status codes provide detailed information about the current state and outcome of financial operations. Each transaction type has specific status codes that reflect its unique processing workflow.

Real-time Tracking

Monitor transaction progress from initiation to completion

Clear State Management

Understand exactly where each transaction stands in processing

Automated Handling

Build logic to handle different status scenarios automatically

Payin

Payin transactions represent funds being deposited into your Localpayment account.

Code	Status	Description
100	InProgress	The payin is pending the confirmation
101	OnHold	The payin is on hold
102	Authorized	The payin was authorized
103	Approved	The payin was confirmed but not credited yet
107	Approved	Card update success
200	Completed	The payin was credited
201	Completed	The payin was credited with a different account than the requested
906	ChargeBack	The payin has a chargeback

Subscriptions

Subscription statuses track recurring payment arrangements, not individual payments.

Code	Status	Description
104	Received	The subscription was received
105	Inprogress	The subscription is in progress
106	Onhold	The subscrition is on hold
202	Completed	The subscription was completed
922	ChargeBack	The subscription on hold - Chargeback in progress

Payout

Payout transactions represent funds being sent from your Localpayment account to beneficiaries.

Code	Status	Description
100	Received	The payout was received
101	Locked	The payout has been confirmed and passed AML validations
102	InProgress	The payout has been sent to the bank
103	OnHold	The provider is not configured
104	PendingAuth	The payout is pending of authorization by client
105	OnHold	OnHold by AML
200	Completed	The payout was debited

Chargeback

Chargebacks are initiated by the cardholder's bank and represent a reversal of a previous Payin.

Code	Status	Description
100	Received	Chargeback has been received
101	DocReceived	Dispute documentation received
102	InDispute	Dispute documentation was sent to the acquire
200	Completed	Chargeback has been completed
201	DisputeLost	Dispute debited
202	DisputeWon	Dispute credited

Credit

Credit transactions represent operations performed using credit cards.

Code	Status	Description
200	Completed	EE REFUNDED
201	Completed	COMMISSION REFUNDED
202	Completed	TAX REFUNDED
203	Completed	TRANSACTION REFUNDED
204	Completed	INVESTMENT
205	Completed	COLLECTION

Currency Exchange

Currency Exchange transactions represent the conversion of funds from one currency to another.

Code	Status	Category	Description
103	Approved		The currency exchange was approved
200	Completed		The currency exchange was finished

Debit

Debit transactions represent operations performed using debit cards.

Code	Status	Description
200	Completed	SWIFT FEE DEBITED
201	Completed	COMMISSION DEBITED
202	Completed	TAX DEBITED
203	Completed	TRANSACTION DEBITED
204	Completed	BANK FEE
205	Completed	SUPPLIERS
206	Completed	BANK CHARGERS
207	Completed	INTEREST

Expenses

Expenses track costs associated with operations (e.g., fees).

Code	Status	Description
200	Completed	Bank fees
201	Completed	Invoice
202	Completed	Lawyer
203	Completed	Accountant

Recall

Recalls are requests to reverse a payment, typically used in specific payment methods or regions.

Code	Status	Description
200	Completed	THE PAYOUT HAS BEEN RECALLED

Refund

Refunds represent the return of funds to a customer for a specific, previously completed Payin.

Code	Status	Description
100	Received	The refund was received
101	Locked	The refund has been confirmed and passed AML validations
102	InProgress	The refund has been sent to the bank
103	OnHold	The refund is on hold
104	PendingAuth	The refund is pending of authorization by client
200	Completed	The payin has been refunded

Return

A Return typically indicates a payment that was sent but could not be delivered to the recipient. This is distinct from a Refund (initiated by the merchant) or a Chargeback (initiated by the cardholder).

Code	Status	Description
200	Completed	THE PAYOUT HAS BEEN RETURNED

Recurring Fee

Recurring Fees are charges related to subscription or account maintenance.

Code	Status	Description
200	Completed	MONTHLY COMMISION
201	Completed	ANNUAL COMMISION
202	Completed	TAX PROCESSING COMMISION
203	Completed	ACCOUNT MAINTENANCE FEE

Wire In

Wire In transactions represent incoming wire transfers.

Code	Status	Description
100	PendingCredit	Pending Credit
200	Completed	Completed

Wire Out

Wire Out transactions represent outgoing wire transfers.

Code	Status	Description
100	PendingAuth	Pending Authorization
101	PendingDebit	In Progress
102	Received	Authorized
200	Completed	Completed

Related Resources

Webhooks Guide

Learn how to receive real-time status updates

API Reference

Complete API endpoint documentation

Error Handling

Guide to handling failed transactions

Support

Get help with specific status issues

💡
Pro Tip: Implement status change logging with both the status code and description. This helps with debugging and provides clear audit trails for compliance requirements.