Manual Bank Transfer (MBT) lets your customers send funds directly from their bank account. Present it as a payment method in your checkout - when the funds land, Augustus matches the incoming transfer to the order and notifies you in real time.
High-level flow
Create an Order
Create an Order. The response includes the destination payment details to display to your customer.
Display payment details
Show the destination to your customer as the payment instructions.
Track the status
Track the order status. It transitions from processing to paid once the funds arrive and reconcile. See the Status Flow page for details. Step-by-step
1. Create an order
import Ivy from '@getivy/node-sdk'
const client = new Ivy()
const order = await client.orders.create({
amount: 1.23,
currency: 'EUR',
referenceId: 'your-internal-reference',
customer: {
email: 'customer@example.com',
},
})
2. Display the payment details
The order’s destination field contains the payment details to show your customer. The shape varies by currency.
EUR (IBAN)
GBP (Sort Code)
{
"destination": {
"bankAccount": {
"iban": {
"iban": "DE34817329488882190",
"accountHolderName": "Test Merchant",
"bic": "BCIRLLLL"
}
},
"bankStatementReference": "ir4d23bcd816e89ef"
}
}
{
"destination": {
"bankAccount": {
"sortCode": {
"sortCode": "123456",
"accountNumber": "1234567890",
"accountHolderName": "John Doe"
}
},
"bankStatementReference": "irf1234556679"
}
}
bankStatementReference is critical - it’s how Augustus matches the incoming transfer to your order.
3. Track the status
When the order is created, its status is processing. Once the payment is received and reconciled into your account, it transitions to paid. If the transfer never arrives or cannot be reconciled, the order stays processing for 6 days and then moves to failed.
Subscribe to the order_updated webhook for real-time updates, or poll the order directly:
import Ivy from '@getivy/node-sdk'
const client = new Ivy()
const order = await client.orders.retrieve({ id: 'your-internal-reference' })
Payments received with an incorrect amount or reference are automatically rejected and returned. Make sure your customer copies all payment details exactly.
Need help?
Contact help@augustus.com. 
