Add a Customer's Bank Account
Attach a payment method to a customer that has completed KYC.
In order to register a FIAT account for a third party, simply call the Create Payment Method endpoint.
Create a First-Party Account
To create a first-party account (owned by the customer), you may omit the isExternal field or set it to false.
curl --location 'https://penny-api-restricted-dev.alfredpay.io/api/v1/third-party-service/penny/fiatAccounts' \
\--header 'Content-Type: application/json' \
\--header 'accept: */*' \
\--header 'api-key: xxxxxxx' \
\--header 'api-secret: xxxxxxx' \
\--data '{
"customerId": "00a8c563-8e11-48f8-8a81-5fe79af779fb",
"type": "SPEI",
"fiatAccountFields": {
"accountNumber": "012180187240503253",
"accountType": "CLABE"
}
}'
Create a Third-Party Account
To create a third-party account (used to send funds to an external beneficiary), set isExternal to true.
curl --location 'https://penny-api-restricted-dev.alfredpay.io/api/v1/third-party-service/penny/fiatAccounts' \
\--header 'Content-Type: application/json' \
\--header 'accept: */*' \
\--header 'api-key: xxxxxxx' \
\--header 'api-secret: xxxxxxx' \
\--data '{
"customerId": "00a8c563-8e11-48f8-8a81-5fe79af779fb",
"type": "SPEI",
"fiatAccountFields": {
"accountNumber": "012180187240503253",
"accountType": "CLABE"
},
"isExternal": true
}'
ℹ️ Notes
The only difference between a first-party and a third-party account is the presence of the isExternal: true field.
If isExternal is not provided, the account will be treated as first-party by default.
alfred allows you to:
Pay a vendor in fiat, even if the original funds are in stablecoins.
Collect fiat from a merchant and deliver stablecoins to a consumer.
Peer-to-peer (P2P) transfers between individuals are supported, subject to applicable limits.
alfred may, at its discretion, request additional information or documentation to support a third-party payment.