Create Payment Method

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.

Language
Click Try It! to start a request and see the response here!