With this service, the calling apps can instruct a provider via OnePipe to send an email to a specified email address or customer_ref. This is a standard email service. The slight difference here is that in the event that a provider needs authorisation details of the account to debit for the value of the email (bank account, wallet, etc) this can be supplied to the provider.
| Info |
|---|
Before you proceed: Please read this. |
...
| Code Block | ||
|---|---|---|
| ||
{
"request_ref":"{{request_ref}}",
"request_type":"send_email",
"auth": {
"type": "bank.account | card | wallet | msisdn",
"secure": "{{encrypted(bank account number | card details | wallet | msisdn)}}", //if payment should be collected realtime, it would be charged here
"auth_provider": "Beeceptor",
"route_mode": null
},
"transaction": {
"mock_mode": "live",
"transaction_ref": "{{transaction_ref}}",
"transaction_desc": "A random transaction",
"transaction_ref_parent": null,
"amount": 0,
"customer":{
"customer_ref": "{{customer_id}}",
"firstname": "Uju",
"surname": "Usmanu",
"email": "ujuusmanu@gmail.com",//the recipient of the message
"mobile_no": "234802343132"
},
"meta":{
"a_key":"a_meta_value_1",
"another_key":"a_meta_value_2"
},
"details": {
"message_body": "Welcome to Lagos",
"message_subject": "A title",
"sender_name": "A Name",
"sender_email": "joe@gmail.com"
}
}
} |
...
| Code Block | ||
|---|---|---|
| ||
{
"status": "Successful",
"message": "Transaction processed successfully",
"data": {
"provider_response_code": "00",
"provider": "Beeceptor",
"errors": null,
"error": null,
"provider_response": {
"delivery_status": "delivered | failed | pending",
"referencecost": "506176447170071200",//in kobo
"delivery_statusreference": "delivered000022200225154318222333334432",
"costmeta":{
"1200",//in kobo"field_key":"field_value",
"field_key":"field_value"
}
}
}
} |
Breakdown of the details object
...