curl --request POST \
--url https://sandbox.api.reap.global/simulation/fiat-deposits \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Reap-Version: <reap-version>' \
--data '
{
"amount": 100.5,
"currency": "<string>",
"senderName": "MOON INC LIMITED",
"reference": "INV-2024-0142"
}
'const options = {
method: 'POST',
headers: {
'Reap-Version': '<reap-version>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
amount: 100.5,
currency: '<string>',
senderName: 'MOON INC LIMITED',
reference: 'INV-2024-0142'
})
};
fetch('https://sandbox.api.reap.global/simulation/fiat-deposits', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://sandbox.api.reap.global/simulation/fiat-deposits"
payload = {
"amount": 100.5,
"currency": "<string>",
"senderName": "MOON INC LIMITED",
"reference": "INV-2024-0142"
}
headers = {
"Reap-Version": "<reap-version>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"accountId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"transactionId": "20240115HKHHXXXX000123456",
"status": "SETTLED",
"amount": 100.5,
"currency": "USD",
"originalAmount": 100.5,
"originalCurrency": "USD",
"senderName": "MOON INC LIMITED",
"reference": "INV-2024-0142",
"occurredAt": "2024-01-15T10:30:00Z",
"createdAt": "2024-01-15T10:30:00Z",
"updatedAt": "2024-01-15T10:35:00Z"
}{
"error": {
"code": "SIMULATION_INVALID_STATE",
"message": "<string>",
"detail": {}
}
}Simulate a fiat deposit
Simulates a bank transfer credited to the project’s master collateral account. The deposit is recorded as already settled, the master balance is credited, and FIAT_DEPOSIT_CREATED is delivered, matching what a reconciled transfer does in production. Only available to Program-Funded projects, which are the ones that have a master collateral account. currency must be one the project accepts top-ups in, which is the project’s billing currency.
curl --request POST \
--url https://sandbox.api.reap.global/simulation/fiat-deposits \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Reap-Version: <reap-version>' \
--data '
{
"amount": 100.5,
"currency": "<string>",
"senderName": "MOON INC LIMITED",
"reference": "INV-2024-0142"
}
'const options = {
method: 'POST',
headers: {
'Reap-Version': '<reap-version>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
amount: 100.5,
currency: '<string>',
senderName: 'MOON INC LIMITED',
reference: 'INV-2024-0142'
})
};
fetch('https://sandbox.api.reap.global/simulation/fiat-deposits', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://sandbox.api.reap.global/simulation/fiat-deposits"
payload = {
"amount": 100.5,
"currency": "<string>",
"senderName": "MOON INC LIMITED",
"reference": "INV-2024-0142"
}
headers = {
"Reap-Version": "<reap-version>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"accountId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"transactionId": "20240115HKHHXXXX000123456",
"status": "SETTLED",
"amount": 100.5,
"currency": "USD",
"originalAmount": 100.5,
"originalCurrency": "USD",
"senderName": "MOON INC LIMITED",
"reference": "INV-2024-0142",
"occurredAt": "2024-01-15T10:30:00Z",
"createdAt": "2024-01-15T10:30:00Z",
"updatedAt": "2024-01-15T10:35:00Z"
}{
"error": {
"code": "SIMULATION_INVALID_STATE",
"message": "<string>",
"detail": {}
}
}Authorizations
API key as Bearer token
Headers
API version (YYYY-MM-DD)
2025-02-14 "2025-02-14"
Body
Simulate a bank transfer credited to the project's master collateral account
Amount the sender transferred, credited to the master account
100.5
0
1234.99
Currency the transfer was sent in, as an ISO 4217 alpha code (e.g. HKD). Must be a currency the project accepts top-ups in.
^[A-Z]{3}$Name of the sender. Randomly generated if omitted.
1 - 255"MOON INC LIMITED"
Reference the sender attached to the transfer. Absent if omitted.
1 - 255"INV-2024-0142"
Response
Response for status 200
Unique fiat deposit identifier
Account credited by the deposit
The bank's unique identifier for the incoming transfer. Use it to reconcile the deposit against a bank statement.
"20240115HKHHXXXX000123456"
Current deposit status
SETTLED "SETTLED"
Amount credited to the account balance
x >= 0100.5
0
1234.99
Currency the credit was applied in
"USD"
"HKD"
"EUR"
Amount of the incoming transfer, as received by the bank
x >= 0100.5
0
1234.99
Currency the transfer was sent in, as the bank reported it. A transfer must be sent in the billing currency of your card program.
"USD"
"HKD"
"EUR"
Name of the sender, when the bank reported one
"MOON INC LIMITED"
Reference the sender attached to the transfer, when present
"INV-2024-0142"
ISO 8601 timestamp of when the bank received the transfer
"2024-01-15T10:30:00Z"
ISO 8601 timestamp of creation
"2024-01-15T10:30:00Z"
ISO 8601 timestamp of last update
"2024-01-15T10:35:00Z"